| 特性 | MagickWand | Imagick | GD |
|---|---|---|---|
| 底層庫 | ImageMagick C API (MagickWand) | ImageMagick C API (MagickWand 封裝) | 內建 GD 庫 |
| API 風格 | 過程式 (函數式) | 面向對象 (類) | 過程式 |
| 功能豐富度 | 完整 ImageMagick 功能 | 完整 ImageMagick 功能 | 基礎繪圖、縮放、水印 |
| 性能/內存 | 流式處理、管道、較低內存 | 對象封裝、略高內存 | 全內存、大圖易 OOM |
| 安裝難度 | 需編譯擴展 + 安裝 ImageMagick | 需編譯擴展 + 安裝 ImageMagick | PHP 內建,零配置 |
| 推薦度 | ⭐⭐⭐⭐ (舊項目維護) | ⭐⭐⭐⭐⭐ (新項目首選) | ⭐⭐⭐ (簡單場景) |
建議:新項目直接使用 **Imagick** (OO 風格、文檔豐富、社區活躍);僅維護舊 MagickWand 代碼時參考本文。
# 1. 安裝 ImageMagick 庫
yum install -y ImageMagick ImageMagick-devel # CentOS/RHEL
apt install -y libmagickwand-dev # Debian/Ubuntu
# 2. 安裝 PHP Imagick 擴展 (推薦) 或 MagickWand
pecl install imagick
# 或
pecl install magickwand
# 3. php.ini 啟用
extension=imagick.so
# extension=magickwand.so
# 4. 重啟 PHP-FPM / Apache
systemctl restart php-fpm
Windows:下載預編譯 DLL (php_imagick.dll / php_magickwand.dll) 放入 ext 目錄,php.ini 啟用,確保 ImageMagick DLL 在 PATH 中。
$wand = NewMagickWand();
// 讀取
MagickReadImage($wand, 'input.jpg');
MagickReadImageBlob($wand, $blob); // 從二進制字符串
// 獲取信息
$w = MagickGetImageWidth($wand);
$h = MagickGetImageHeight($wand);
$format = MagickGetImageFormat($wand);
// 縮放 (保持比例)
MagickThumbnailImage($wand, 800, 0); // 高度 0 表示按寬度等比
MagickResizeImage($wand, 800, 600, FILTER_LANCZOS, 1); // 精確尺寸
// 裁剪
MagickCropImage($wand, 400, 300, 100, 50); // 寬、高、x、y
// 旋轉
MagickRotateImage($wand, $bgColor, 45); // 背景色 PixelWand
// 文字繪製
$draw = NewDrawingWand();
$pixel = NewPixelWand();
PixelSetColor($pixel, 'white');
DrawSetFont($draw, '/path/to/font.ttf');
DrawSetFontSize($draw, 24);
DrawSetFillColor($draw, $pixel);
DrawSetGravity($draw, MW_CenterGravity);
MagickAnnotateImage($wand, $draw, 0, 0, 0, '水印文字');
// 格式轉換/質量
MagickSetImageFormat($wand, 'webp');
MagickSetImageCompressionQuality($wand, 85);
// 輸出
header('Content-Type: image/webp');
MagickEchoImageBlob($wand); // 直接輸出到瀏覽器
// 或保存
MagickWriteImage($wand, 'output.webp');
// 清理
DestroyMagickWand($wand);
// 大圖處理不載入全量內存:使用 MagickReadImageStream / 管道
$wand = NewMagickWand();
MagickReadImage($wand, 'huge.tiff'); // ImageMagick 內部使用磁盤緩存
// 多幀 (GIF/動圖) 處理
MagickSetFirstIterator($wand);
do {
// 對每幀操作
MagickResizeImage($wand, 300, 200, FILTER_LANCZOS, 1);
} while (MagickNextImage($wand));
// 合成圖層
$bg = NewMagickWand();
MagickReadImage($bg, 'bg.png');
$fg = NewMagickWand();
MagickReadImage($fg, 'logo.png');
MagickCompositeImage($bg, $fg, MW_OverCompositeOp, 10, 10);
MagickWriteImage($bg, 'merged.png');
| 現象 | 原因 | 解決 |
|---|---|---|
| Class 'Imagick' not found | 擴展未安裝/未啟用/版本不匹配 | pecl install imagick、檢查 php -m、重啟服務 |
| PDF 讀取失敗 / 權限錯誤 | ImageMagick policy.xml 限制 PDF | 編輯 /etc/ImageMagick-6/policy.xml,註釋 <policy domain="coder" rights="none" pattern="PDF" /> |
| 字體找不到 | DrawSetFont 路徑錯誤 | 使用絕對路徑、確認字體文件存在、安裝 fontconfig |
| 內存耗盡 | 大圖全量載入 | 使用 MagickReadImageStream、設置 MAGICK_MEMORY_LIMIT 環境變量、分塊處理 |
| 顏色異常 | 色彩空間不匹配 (CMYK vs sRGB) | MagickTransformImageColorspace($wand, MW_sRGBColorspace) |
ImageMagick (MagickWand/Imagick) 是 PHP 圖像處理的**工業級選擇**,支援 200+ 格式、色彩管理、向量圖形、批量處理。新項目請使用 **Imagick OO API**,配合 php-imagick 官方文檔與 ImageMagick 命令行參考,構建高性能、高質量的圖像處理管線。