PHP 追加編譯 pdo_mysql 與 mbstring 擴展實戰筆記

PHP 安裝後需動態新增擴展，不重新編譯主程式，使用 phpize 追加編譯 pdo_mysql 與 mbstring 的標準流程。

一、編譯安裝 pdo_mysql

# 1. 下載原始碼
wget https://pecl.php.net/get/PDO_MYSQL-1.0.2.tgz
tar zxf PDO_MYSQL-1.0.2.tgz && cd PDO_MYSQL-1.0.2

# 2. phpize 產生建置腳本
/usr/local/php/bin/phpize

# 3. 配置並編譯（指定 php-config 與 MySQL 路徑）
./configure --with-php-config=/usr/local/tcrm/php/bin/php-config --with-pdo-mysql=/usr/local/mysql
make && make install

# 4. 修改 php.ini 載入擴展
extension_dir = "/usr/local/tcrm/php/lib/php/extensions/no-debug-non-zts-20060613/"
extension=pdo_mysql.so

# 5. 重啟 Web 服務生效
service nginx reload  # 或 apachectl graceful

二、追加編譯 mbstring

cd /tmp/php-5.2.14/ext/mbstring/
/usr/local/php/bin/phpize
./configure --with-php-config=/usr/local/tcrm/php/bin/php-config
make && make install

# php.ini 新增
extension=mbstring.so

關鍵要點總結

• phpize 來源必須與執行中 PHP 版本一致（路徑指向正確的 php/bin/phpize）
• --with-php-config 指向對應的 php-config，確保編譯參數一致
• extension_dir 必須為 make install 輸出的實際目錄（含 API 版本號）
• 編譯前確認系統已安裝 php-devel、mysql-devel 等開發套件
• 多版本 PHP 共存時，嚴格區分各版本的 phpize/php-config/extension_dir

此法適用於所有 PECL 擴展與 PHP 內建擴展（ext/ 目錄下），是不重編 PHP 主體擴展功能的標準作法。