PHP 圖像處理擴展 MagickWand 安裝與實戰範例

前言

MagickWand 是 PHP 連接 ImageMagick 的官方擴展，提供物件導向 API 操作影像。相較 GD 库，支援格式更多（超過 200 種）、處理大圖記憶體效率更高、功能更強大（如向量圖形、色彩空間轉換、複雜濾鏡）。本文涵蓋安裝、兩種架構差異、基本操作範例。

一、兩種安裝架構差異

二、安裝步驟（以 Windows + 外掛模式為例）

1. 下載對應 PHP 版本、執行緒安全性的 php_magickwand.dll（如 php_magickwand_q16_ts.dll for PHP 7.x TS）。
2. 將 DLL 放入 PHP ext/ 目錄。
3. 安裝 ImageMagick（勾選「Install legacy utilities」與「Add to PATH」）。
4. 修改 php.ini：extension=php_magickwand.dll。
5. 重啟 Apache/Nginx，phpinfo() 確認 magickwand 區塊出現。

三、基本操作範例：文字浮水印

<?php
// 1. 建立 MagickWand 物件
$mw = NewMagickWand();

// 2. 讀取圖片
MagickReadImage($mw, 'rose.jpg');

// 3. 建立繪圖物件
$dw = NewDrawingWand();
DrawSetFont($dw, '/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf');  // 字體路徑
DrawSetFontSize($dw, 24);
DrawSetGravity($dw, MW_CenterGravity);  // 置中

// 4. 設定文字顏色（白色）
$pw = NewPixelWand();
PixelSetColor($pw, 'white');
DrawSetFillColor($dw, $pw);

// 5. 寫入文字
if (MagickAnnotateImage($mw, $dw, 0, 0, 0, 'Sample Watermark') !== 0) {
    // 6. 輸出圖片
    header('Content-Type: image/jpeg');
    MagickEchoImageBlob($mw);
} else {
    echo '錯誤：' . MagickGetExceptionString($mw);
}

// 7. 釋放資源
DestroyMagickWand($mw);
DestroyDrawingWand($dw);
DestroyPixelWand($pw);
?>

四、常用操作速查表

五、MagickWand vs Imagick vs GD

• MagickWand：C 語言風格 API、輕量、官方維護、效能極佳。
• Imagick：物件導向包裝、功能相近、社群資源較多、記憶體佔用稍高。
• GD：內建、無需額外安裝、功能有限（不支援 WebP 動圖、ICC 色彩配置檔、大圖處理易 OOM）。

建議：新專案優先考慮 Imagick（文件豐富、社群活躍），若追求極致效能或嵌入式環境可用 MagickWand。

六、常見問題排查

• 找不到字體： 使用絕對路徑，Linux 常見 /usr/share/fonts/，Windows C:/Windows/Fonts/。
• 權限錯誤： 確認 PHP 進程對圖檔、字體、臨時目錄有讀寫權限。
• 記憶體不足： ImageMagick 可透過 policy.xml 限制資源，或分塊處理大圖。

小結

MagickWand 為 PHP 專業影像處理提供工業級能力。安裝雖需額外步驟，但換來格式支援廣、大圖處理穩、功能全的優勢，遠超 GD。實務上搭配 Imagick 物件導向介面開發效率更高，兩者底層同為 ImageMagick，可依團隊習慣選擇。