萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 免重新編譯動態載入擴展:以 FTP 為例的 phpize 實戰

適用場景

  • 生產環境無法重新編譯 PHP
  • 需快速啟用官方擴展 (ftp, gd, intl, redis, swoole 等)
  • 多 PHP 版本共存,單獨為某版本加裝擴展

前置條件

  • 原始碼包 php-.tar.gz (與執行中版本一致)
  • 已安裝 phpize、php-config、編譯工具鏈 (gcc, make, autoconf)
  • 目標擴展原始碼在 ext/ 目錄下

完整步驟 (以 FTP 為例)

# 1. 進入擴展原始碼目錄
cd /usr/src/php-8.2.10/ext/ftp

# 2. 執行 phpize 生成 configure
/usr/local/php/bin/phpize
# 輸出確認:
# Configuring for:
# PHP Api Version: 20220829
# Zend Module Api No: 20220829
# Zend Extension Api No: 420220829

# 3. 配置編譯選項 (指定 php-config)
./configure --with-php-config=/usr/local/php/bin/php-config
# 可加 --enable-ftp (部分擴展需顯式啟用)

# 4. 編譯安裝
make -j$(nproc) && make install
# 輸出:Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20220829/

# 5. 建立擴展儲存目錄 (可自定)
mkdir -p /usr/local/php/etc/ext

# 6. 複製 .so 到自定目錄 (方便管理)
cp /usr/local/php/lib/php/extensions/no-debug-non-zts-20220829/ftp.so /usr/local/php/etc/ext/

# 7. 修改 php.ini 載入擴展
# 找到 extension_dir 並修改/新增
extension_dir = "/usr/local/php/etc/ext"
extension = ftp.so

# 8. 重啟 PHP-FPM / Apache 生效
systemctl restart php-fpm
# 或
systemctl restart httpd

驗證載入

php -m | grep ftp
# 或
php -r 'var_dump(extension_loaded("ftp"));'

常見問題排查

問題原因解決
phpize: command not found未安裝 php-dev / php-devel 套件apt/yum install php-dev
configure: error: Cannot find php-config路徑錯誤用 which php-config 確認路徑
make: *** No targets specified非擴展目錄執行確保在 ext/ftp 目錄下
undefined symbol: executor_globalsPHP 版本不匹配 (API 版本不同)使用完全相同版本原始碼編譯
extension_loaded 為 falsephp.ini 未生效/路徑錯誤php --ini 確認載入的 ini,檢查 extension_dir

批次化腳本 (自動偵測版本)

#!/bin/bash
# install_ext.sh 
EXT=$1
PHP_BIN=$(which php)
PHP_CONFIG=$(which php-config)
PHP_SRC=$(php -r 'echo PHP_SOURCE_PATH ?? "/usr/src/php";') # 需自行設定

cd "$PHP_SRC/ext/$EXT"
$PHP_BIN/phpize
./configure --with-php-config=$PHP_CONFIG
make -j$(nproc) && make install

EXT_DIR=$(php -r 'echo ini_get("extension_dir");')
cp $(php -r "echo PHP_EXTENSION_DIR . '/$EXT.so';") "$EXT_DIR/"
echo "extension=$EXT.so" >> $(php --ini | grep 'Loaded Configuration' | awk '{print $4}')
echo "Done. Restart PHP to activate."

現代替代:PECL 安裝

# 直接從 PECL 下載編譯安裝 (自動處理版本相容)
pecl install ftp
# 或指定版本
pecl install redis-5.3.7
# 會自動修改 php.ini (若有權限)

PECL 需網路連線,離線環境仍需手動 phpize。

copyright © 萬盛學電腦網 all rights reserved