如果您在 macOS 上工作並且需要安裝 Imagick for PHP 8.3，則可能會遇到預設安裝較舊版本 PHP（例如 PHP 8.0）的問題。在這篇文章中，我將引導您完成確保 Imagick 已安裝並針對 PHP 8.3 正確配置的步驟。

步驟 1：透過 Homebrew 安裝 PHP 8.3

首先，請確保 PHP 8.3 已安裝並設定為預設版本。

1. 安裝 PHP 8.3：

   brew install [email protected]

1. 連結 PHP 8.3 使其成為系統上的預設版本：

   brew link --overwrite --force [email protected]

1. 透過檢查版本來驗證 PHP 8.3 是否處於活動狀態：

   php -v

您應該會看到 PHP 8.3.x 作為輸出。

步驟 2：安裝 pkg-config 和 ImageMagick

在安裝Imagick PHP擴充功能之前，我們需要安裝pkg-config和ImageMagick：

1. 透過 Homebrew 安裝 pkg-config 和 ImageMagick：

   brew install pkg-config imagemagick

此步驟可確保在您的系統上提供 Imagick 所需的庫和配置。

步驟 3：安裝適用於 PHP 8.3 的 Imagick

現在 PHP 8.3 已設定為預設版本，我們可以安裝 Imagick 擴充功能了。

1. 使用 PECL 安裝 Imagick for PHP 8.3。由於預設命令可能仍然指向 PHP 8.0，因此我們需要確保使用 PHP 8.3 的正確 php-config：

   /opt/homebrew/opt/[email protected]/bin/pecl install imagick

1. 如果 PECL 未如預期運作，或者您正在手動安裝，請在 Imagick 安裝過程中明確指定正確的 php-config：

   /private/tmp/pear/temp/imagick/configure --with-php-config=/opt/homebrew/opt/[email protected]/bin/php-config --with-imagick

步驟 4：在 PHP 8.3 中啟用 Imagick

Imagick安裝完成後，需要在PHP的設定檔(php.ini)中啟用它。

1. 開啟 PHP 8.3 的 php.ini 檔案：

   nano /opt/homebrew/etc/php/8.3/php.ini

1. 新增以下行以啟用 Imagick 擴充：

   extension=imagick.so

步驟 5：重新啟動 PHP 或 Web 伺服器

啟用 Imagick 擴充功能後，重新啟動您的 Web 伺服器或 PHP 服務以使變更生效：

• 對阿帕契：

  sudo apachectl restart

• 為 PHP-FPM：

  sudo brew services restart [email protected]

第 6 步：驗證 Imagick 安裝

最後，驗證Imagick擴充功能是否已成功安裝並啟用。您可以使用以下命令進行檢查：

php -m | grep imagick

或者，您可以使用 phpinfo() 建立 PHP 腳本來檢查 Imagick 擴充功能是否已載入。

結論

按照以下步驟，您可以在 macOS 上成功安裝並啟用適用於 PHP 8.3 的 Imagick 擴充功能。確保使用正確的 php-config 是避免版本衝突並確保 Imagick 與 PHP 8.3 配合使用的關鍵。

如果您遇到任何問題或對設定有疑問，請隨時發表評論！