php-.tar.gz (與執行中版本一致)phpize、php-config、編譯工具鏈 (gcc, make, autoconf)ext/ 目錄下# 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_globals | PHP 版本不匹配 (API 版本不同) | 使用完全相同版本原始碼編譯 |
| extension_loaded 為 false | php.ini 未生效/路徑錯誤 | php --ini 確認載入的 ini,檢查 extension_dir |
#!/bin/bash # install_ext.shEXT=$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 install ftp # 或指定版本 pecl install redis-5.3.7 # 會自動修改 php.ini (若有權限)
PECL 需網路連線,離線環境仍需手動 phpize。