PHP Imagick 實現 JPG 合成 GIF 動圖完整教程：從擴展安裝到幀控制

利用 PHP Imagick 擴展 (php_imagick_st-Q8.dll) 可將多張 JPG 圖片合成 GIF 動畫，支援幀延遲控制、迴圈設定、最佳化壓縮。本文詳述 Windows 環境下 DLL 安裝配置、核心合成代碼、關鍵參數調優、常見坑點與解決方案。

一、環境需求與擴展安裝 (Windows)

1. 下載對應版本 DLL

• PHP 版本：php -v 確認 (如 7.4.33 NTS x64)
• 下載：PECL 官方發布頁 選擇匹配的 php_imagick-<版本>---.zip
• 解壓取出 php_imagick.dll (無需 Q8/Q16 後綴，新版統一)

2. 安裝 ImageMagick 執行檔 (必要)

• 下載：ImageMagick Windows 安裝程式
• 安裝時勾選 Add to PATH 與 Install legacy utilities (convert.exe 等)
• 驗證：CMD 執行 magick -version 顯示版本即成功

3. 配置 php.ini

extension=imagick
; 可選：設定資源限制防止記憶體耗盡
; imagick.memory_limit=256M
; imagick.map_limit=512M

4. 重啟 Web 服務並驗證

# Apache
httpd -k restart

# Nginx + PHP-FPM
systemctl restart php-fpm  # Linux
# Windows 重啟 PHP-FPM 服務或 IIS

php -m | findstr imagick 或 phpinfo() 搜尋 imagick 區塊確認載入成功。

二、核心合成代碼

setFormat($type); // 設定輸出格式
    $animation->setIteratorIndex(0);

    // 3. 逐幀加入並設定延遲
    foreach ($filelist as $file) {
        if (!is_file($file)) {
            throw new RuntimeException("圖片不存在: $file");
        }
        
        $frame = new Imagick();
        $frame->readImage($file);
        
        // 可選：統一尺寸 (避免尺寸不一導致閃爍)
        // $frame->resizeImage(800, 600, Imagick::FILTER_LANCZOS, 1);
        
        $animation->addImage($frame);
        $animation->setImageDelay($delay); // 當前幀延遲
        
        // 釋放單幀記憶體
        $frame->clear();
        $frame->destroy();
    }

    // 4. 設定迴圈次數 (0 = 無限循環)
    $animation->setOption('loop', 0);

    // 5. 最佳化 (減小檔案體積)
    $animation = $animation->optimizeImageLayers();

    // 6. 生成輸出檔名
    $filename = $prefix . time() . '.' . $type;
    $fullPath = $savePath . $filename;

    // 7. 寫入檔案
    $animation->writeImages($fullPath, true); // true = 合併多幀為單檔

    // 8. 清理記憶體
    $animation->clear();
    $animation->destroy();

    // 9. 回傳結果
    return [
        'filename' => $filename,
        'path'     => $fullPath,
        'url'      => $savePath . $filename, // 相對 Web 根目錄
    ];
}

// ===== 使用範例 =====
$filelist = ['1.jpg', '2.jpg', '3.jpg', '4.jpg'];
$result = createGifAnimation($filelist, 'gif', 200, 'new_', './gif/', true);

if ($result) {
    echo "已生成 GIF: {$result['filename']}
";
    echo "";
}

三、關鍵參數深度解析

四、常見問題與解決

1. 生成的 GIF 只有第一幀 / 靜態圖
   • 確認 writeImages($path, true) 第二參數為 true
   • 確認每幀都呼叫了 setImageDelay()
   • 檢查瀏覽器是否支援動畫 GIF (皆支援)
2. 記憶體耗盡 (Allowed memory exhausted)
   • 大量/高解析度圖片請分批處理或先縮圖
   • 調大 memory_limit 或 imagick.memory_limit
   • 及時呼叫 clear()/destroy() 釋放
3. Windows 下找不到 ImageMagick 委派庫
   • 確認 ImageMagick 安裝目錄在系統 PATH 中
   • 重啟 PHP-FPM/Apache 讓 PATH 生效
4. GIF 色彩失真 (256 色限制)
   • GIF 固定 256 色，漸層圖片會抖動
   • 考慮改用 WebP 動畫 (支援 24 位色 + Alpha)

五、進階：WebP 動畫替代方案 (現代瀏覽器)

// Imagick 同樣支援 WebP 動畫
$animation->setFormat('webp');
$animation->setOption('loop', 0);
$animation->writeImages('animation.webp', true);
// 體積較 GIF 小 30-50%，畫質更好，支援透明背景

掌握 Imagick 幀級控制與記憶體管理，即可構建高效穩定的圖片動畫生成服務。