CentOS 環境下 PHP PDO_MySQL 擴展編譯安裝完整指南

前言

在 CentOS 等紅帽系列 Linux 發行版上，為 PHP 安裝 PDO_MySQL 擴展是連接 MySQL 資料庫的基礎步驟。本文將詳細記錄從原始碼編譯安裝的完整流程，幫助開發者快速部署生產環境。

準備工作

確認 PHP 原始碼包與安裝路徑。本文範例中：

• PHP 原始碼位置：/tmp/lamp/php-5.3.19
• PHP 安裝目錄：/usr/local/php
• MySQL 安裝目錄：/usr/local/mysql

步驟 1：進入擴展目錄並執行 phpize

cd /tmp/lamp/php-5.3.19/ext/pdo_mysql/
/usr/local/php/bin/phpize

執行成功後，目錄下會生成 configure 腳本。

步驟 2：配置編譯參數

./configure --with-php-config=/usr/local/php/bin/php-config --with-pdo-mysql=/usr/local/mysql/

參數說明：

• --with-php-config：指定 PHP 安裝時的配置檔路徑
• --with-pdo-mysql：指定 MySQL 安裝根目錄

步驟 3：編譯與安裝

make && make install

編譯完成後，終端會輸出生成 pdo_mysql.so 的具體目錄（例如 /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/），請務必記下此路徑。

步驟 4：修改 php.ini 載入擴展

編輯 php.ini，在適當位置新增：

extension=/usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/pdo_mysql.so

路徑需與上一步輸出的實際目錄一致。

步驟 5：驗證安裝

1. 重啟 Apache 服務：service httpd restart
2. 建立 phpinfo.php 並訪問，搜尋 pdo_mysql 區塊

若出現 PDO 驅動資訊，即表示安裝成功。

常見問題排查

• 找不到 phpize：確認 php-devel 套件已安裝（yum install php-devel）
• MySQL 庫缺失：檢查 --with-pdo-mysql 路徑是否指向含 include、lib 的根目錄
• 擴展不生效：核對 extension_dir 設定與 .so 實際路徑是否一致