在我的一个个人项目中，我需要根据上传的图片动态调整网站的主题色。手动提取每张图片的主色调显然是不现实的，因此我开始寻找一个自动化的解决方案。我尝试了一些在线工具和复杂的图像处理库，但它们要么不够灵活，要么过于复杂，难以集成到我的项目中。
偶然间，我发现了 ksubileau/color-thief-php 这个库。它是一个 php 库，可以从图像中提取主色调或代表性的调色板。它是 color thief javascript 库的 php 移植版本，使用了来自 leptonica 库的 mmcq（改进的中值切割量化）算法。
Composer在线学习地址：学习地址
ksubileau/color-thief-php 的优势在于：
- 简单易用： 只需要几行代码即可完成图像主色调的提取。
- 支持多种图像格式： 支持 JPEG、PNG、GIF 和 WEBP 图像。
- 多种图像处理扩展支持： 支持 GD, Imagick 或 Gmagick 扩展。
- 灵活的配置选项： 可以调整提取质量、指定提取区域、选择输出格式。
- 无需复杂的图像处理知识： 开发者无需深入了解图像处理算法，即可轻松使用。
安装
使用 Composer 安装 ksubileau/color-thief-php 非常简单：
立即学习“PHP免费学习笔记（深入）”；
composer require ksubileau/color-thief-php
使用示例
以下是一个简单的示例，展示如何提取图像的主色调：
require_once 'vendor/autoload.php';
use ColorThief\ColorThief;
$sourceImage = 'path/to/your/image.jpg'; // 图像路径
try {
$dominantColor = ColorThief::getColor($sourceImage);
// $dominantColor 是一个包含 RGB 值的数组，例如：[255, 0, 0]
echo "主色调：RGB(" . implode(',', $dominantColor) . ")";
} catch (Exception $e) {
echo "提取主色调失败：" . $e->getMessage();
}
你还可以提取图像的调色板：
require_once 'vendor/autoload.php';
use ColorThief\ColorThief;
$sourceImage = 'path/to/your/image.jpg'; // 图像路径
try {
$palette = ColorThief::getPalette($sourceImage, 8); // 提取 8 种颜色
// $palette 是一个包含多个 RGB 数组的数组
echo "调色板：";
foreach ($palette as $color) {
echo "RGB(" . implode(',', $color) . ") ";
}
} catch (Exception $e) {
echo "提取调色板失败：" . $e->getMessage();
}通过简单的配置，你可以调整提取质量、指定提取区域，甚至选择不同的输出格式（例如 RGB 字符串、十六进制颜色值等）。
实际应用效果
在我的项目中，我使用 ksubileau/color-thief-php 提取用户上传图片的主色调，并将其应用到网站的背景色、按钮颜色和文本颜色上。这使得网站的视觉风格能够与用户上传的图片保持一致，提升了用户体验。
总而言之，ksubileau/color-thief-php 是一个非常实用的 PHP 库，它能够帮助开发者轻松提取图像的主色调和调色板，为网站带来更具吸引力的视觉效果。它简单易用、功能强大，并且具有灵活的配置选项，非常适合在各种 Web 开发项目中使用。
