在為 PHP 安裝 imagick 擴展時，configure: error: Cannot locate header file MagickWand.h 是高頻報錯。本文記錄根因分析與通用解決方案，適用於 Linux 服務器環境。
$ ./configure --with-php-config=/usr/local/php/bin/php-config
...
checking for MagickWand.h header file... configure: error: Cannot locate header file MagickWand.h環境：PHP 5.4.13、ImageMagick 6.8.3-10、imagick 3.0.1。
ImageMagick 6.8+ 版本調整了頭文件安裝路徑：
/usr/local/include/ImageMagick//usr/local/include/ImageMagick-6/（版本號後綴）imagick 的 configure 腳本默認搜尋舊路徑，導致找不到 MagickWand.h。
# 將新版路徑鏈接到舊版預期路徑
ln -s /usr/local/include/ImageMagick-6 /usr/local/include/ImageMagick
# 重新編譯
make clean
./configure --with-php-config=/usr/local/php/bin/php-config
make && make install編譯通過後，在 php.ini 添加 extension=imagick.so，重啟 PHP-FPM 驗證：
php -m | grep imagick
# 或
php -r "phpinfo();" | grep imagick若不想建立軟鏈接，可顯式指定 ImageMagick 的 pkg-config 路徑：
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
./configure --with-php-config=/usr/local/php/bin/php-config --with-imagick=/usr/local前提是 ImageMagick 安裝時生成了 ImageMagick.pc 文件（通常在 /usr/local/lib/pkgconfig/）。
| 問題 | 原因 | 解決 |
|---|---|---|
編譯通過但 PHP 啟動報 undefined symbol | imagick 版本與 ImageMagick 運行時庫版本不匹配 | 確保編譯、運行使用同一版本 ImageMagick；ldd /usr/local/php/lib/php/extensions/.../imagick.so 檢查鏈接 | PHP 7/8 編譯 imagick 失敗 | 舊版 imagick 不支援新 PHP API | 安裝 imagick 3.4.4+（PHP 7）或 3.6.0+（PHP 8），從 PECL 獲取最新版 |
缺少 pkg-config 命令 | 系統未安裝 pkg-config 工具 | yum install pkgconfig 或 apt-get install pkg-config |
| 權限不足 | 非 root 用戶編譯安裝 | 使用 sudo make install 或配置 --prefix 到用戶目錄 |
<?php
$imagick = new Imagick();
$imagick->readImage('test.jpg');
$imagick->resizeImage(200, 200, Imagick::FILTER_LANCZOS, 1);
$imagick->writeImage('test_thumb.jpg');
echo 'OK';
?>若報 Unable to read image，檢查 policy.xml（通常在 /etc/ImageMagick-6/policy.xml）是否限制了 read/write 操作，調整 <policy domain="coder" rights="read|write" pattern="JPG" />。
MagickWand.h 找不到本質是 ImageMagick 版本升級導致頭文件路徑變更。建立符號鏈接 ln -s ImageMagick-6 ImageMagick 是最快通用修復；長期維護建議在編譯腳本中檢測版本並自動適配路徑。
