PHP Imagick 獲取圖片主色調 RGB 值高效方案

PHP Imagick 獲取圖片主色調 RGB 值高效方案

圖片網站常需根據用戶上傳圖片提取主色調，用于色系搜索、推薦、UI 自適應配色。傳統遍歷像素統計 RGB 頻率效率極低且不準。本文介紹基于 Imagick::quantizeImage() 降色量化算法的高效方案。

核心原理

quantizeImage() 將圖片顏色空間減少到指定顏色數（如 10 色），自動聚類相似顏色，保留視覺上最具代表性的調色板。隨后 uniqueImageColors() 進一步去重，最終通過像素迭代器讀取剩餘顏色，即為主色調集合。

完整代碼實現

<?php
function getImageMainColors($imagePath, $colorCount = 10) {
    if (!extension_loaded('imagick')) {
        throw new RuntimeException('Imagick 擴展未安裝');
    }
    if (!file_exists($imagePath)) {
        throw new InvalidArgumentException("圖片不存在: $imagePath");
    }

    $im = new Imagick($imagePath);
    // 1. 縮略圖加速（可選，大圖建議先縮放至 200px 寬）
    $im->thumbnailImage(200, 0, true);

    // 2. 量化：減少到 $colorCount 種顏色，RGB 空間，無抖動，無樹深度限制
    $im->quantizeImage($colorCount, Imagick::COLORSPACE_RGB, 0, false, false);

    // 3. 去重唯一顏色
    $im->uniqueImageColors();

    // 4. 遍歷像素獲取 RGB
    $colors = [];
    $it = $im->getPixelIterator();
    $it->resetIterator();
    while ($row = $it->getNextIteratorRow()) {
        foreach ($row as $pixel) {
            $c = $pixel->getColor(); // ['r'=>255, 'g'=>128, 'b'=>0, 'a'=>255]
            // 過濾透明度極低的顏色
            if (($c['a'] ?? 255) > 128) {
                $colors[] = "rgb({$c['r']},{$c['g']},{$c['b']})";
            }
        }
    }
    $im->destroy(); // 釋放內存
    return array_unique($colors); // 去重
}

// 使用示例
try {
    $mainColors = getImageMainColors('uploads/photo.jpg', 8);
    echo "<div style='display:flex; gap:8px;'>";
    foreach ($mainColors as $rgb) {
        echo "<div style='width:40px;height:40px;background:$rgb;border:1px solid #ddd;' title='$rgb'></div>";
    }
    echo "</div>";
} catch (Exception $e) {
    echo "錯誤: " . $e->getMessage();
}
?>

參數調優建議

對比：為什麼不用遍歷像素統計？

• 性能：1000x1000 圖遍歷 100 萬像素，PHP 層面循環耗時秒級；量化僅需毫秒級。
• 準確度：像素統計易受噪點、漸變干擾，量化算法基于顏色空間聚類，結果更符合視覺主色調。
• 內存：Imagick 內部 C 級處理，峰值內存遠低于 PHP 數組統計。

無 Imagick 環境的替代方案

• GD + 色彩直方圖：imagecolorstotal() + imagecolorsforindex() 讀取調色板（僅適用 GIF/PNG-8）。
• 第三方 API：如 Cloudinary、Imgix 提供 colors 參數直接返回主色調 JSON。
• Node.js sharp / Python Pillow：微服務化處理，PHP 只負責調用 HTTP API。