在我的一个个人项目中，我需要根据上传的图片动态调整网站的主题色。手动提取每张图片的主色调显然是不现实的，因此我开始寻找一个自动化的解决方案。我尝试了一些在线工具和复杂的图像处理库，但它们要么不够灵活，要么过于复杂，难以集成到我的项目中。

偶然间，我发现了 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 非常简单：

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 开发项目中使用。