如何編譯 PHP 模組

在使用 ServBay 進行 PHP 開發時，您可能需要編譯和安裝額外的 PHP 模組，以擴展 PHP 的功能。本文將介紹如何在 ServBay 環境中編譯 PHP 模組，具體包括編譯 imagick 模組和 sqlsrv 模組。

前提條件

在開始編譯 PHP 模組之前，請確保您已經完成了編譯環境的初始化。 有關如何初始化編譯環境的詳細步驟，請參考文件 使用 ServBay 進行二次編譯。

指定 PHP 版本的重要性

ServBay 附帶了多個 PHP 版本，在使用 phpize、php-config 和其他工具進行編譯時，務必指定您所用的 PHP 版本。這是因為不同版本的 PHP 可能有不同的配置和依賴，選擇正確的版本可以避免編譯錯誤和運行時問題。

本例子以 PHP 8.3 為例。

編譯 PHP imagick 模組

imagick 模組是 PHP 的一個擴展，用於處理圖像操作。以下是編譯 imagick 模組的步驟：

步驟 1：下載源碼

首先，從 PECL 下載 imagick 模組的源碼包。

wget https://pecl.php.net/get/imagick-3.7.0.tgz

步驟 2：解壓源碼包

解壓下載的源碼包。

tar zxvf imagick-3.7.0.tgz
cd imagick-3.7.0

步驟 3：生成配置文件

使用 phpize 生成配置文件。在此過程中，請務必指定您所使用的 PHP 版本。例如，如果您使用的是 PHP 8.3，請運行以下命令：

${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/phpize

步驟 4：配置編譯選項

配置編譯選項，指定 PHP 的配置路徑。

./configure --with-php-config=${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/php-config

步驟 5：編譯和安裝

編譯併安裝 imagick 模組。

make -j ${CPU_NUMBER}
make install

步驟 6：啟用模組

在 PHP 的 conf.d 目錄下創建一個 imagick.ini 文件以啟用 imagick 模組。例如：

echo "extension=imagick.so" > /Applications/ServBay/package/etc/php/8.3/conf.d/imagick.ini

步驟 7：驗證模組加載

通過 ServBay 管理面板重啟 PHP 服務，然後通過命令行驗證模組是否成功加載：

php-8.3 -m | grep imagick

如果模組已成功加載，您應該會看到 imagick 出現在輸出結果中。

編譯 PHP sqlsrv 模組

sqlsrv 模組是 PHP 的一個擴展，用於與 Microsoft SQL Server 進行交互。以下是編譯 sqlsrv 模組的步驟：

步驟 1：下載源碼

首先，從 PECL 下載 sqlsrv 模組的源碼包。

wget https://pecl.php.net/get/sqlsrv-5.12.0.tgz

步驟 2：解壓源碼包

解壓下載的源碼包。

tar zxvf sqlsrv-5.12.0.tgz
cd sqlsrv-5.12.0

步驟 3：生成配置文件

使用 phpize 生成配置文件。在此過程中，請務必指定您所使用的 PHP 版本。例如，如果您使用的是 PHP 8.3，請運行以下命令：

${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/phpize

步驟 4：配置編譯選項

配置編譯選項，指定 PHP 的配置路徑。

./configure --with-php-config=${SERVBAY_PACKAGE_FULL_PATH}/php/8.3/current/bin/php-config

步驟 5：編譯和安裝

編譯並安裝 sqlsrv 模組。

make -j ${CPU_NUMBER}
make install

步驟 6：啟用模組

在 PHP 的 conf.d 目錄下創建一個 sqlsrv.ini 文件以啟用 sqlsrv 模組。例如：

echo "extension=sqlsrv.so" > /Applications/ServBay/package/etc/php/8.3/conf.d/sqlsrv.ini

步驟 7：驗證模組加載

通過 ServBay 管理面板重啟 PHP 服務，然後通過命令行驗證模組是否成功加載：

php-8.3 -m | grep sqlsrv

如果模組已成功加載，您應該會看到 sqlsrv 出現在輸出結果中。

總結

通過上述步驟，您可以在 ServBay 環境中編譯並安裝所需的 PHP 模組。在編譯過程中，務必指定正確的 PHP 版本，以確保模組與您的 PHP 環境兼容。希望本文能幫助您順利完成 PHP 模組的編譯和啟用工作。