PDO (PHP Data Objects) 提供統一的資料庫存取介面,pdo_mysql 是連接 MySQL/MariaDB 的核心驅動。本文詳細記錄在 CentOS (Linux) 及 Windows 環境下,從原始碼編譯安裝、配置 php.ini 到常見問題排查的完整流程。
# 安裝編譯工具鏈與 PHP 開發頭文件
yum install -y gcc make php-devel mysql-devel
# 或 Ubuntu/Debian
apt-get install -y build-essential php-dev libmysqlclient-dev
# 方式 A: 從 PECL 下載特定版本
wget https://pecl.php.net/get/PDO_MYSQL-1.0.2.tgz
tar -zxvf PDO_MYSQL-1.0.2.tgz
cd PDO_MYSQL-1.0.2
# 方式 B: 使用 PHP 源碼包內的 ext/pdo_mysql 目錄
# cd /path/to/php-src/ext/pdo_mysql
/usr/local/php/bin/phpize
# 輸出應顯示 PHP Api Version、Zend Module Api No 等信息
./configure \
--with-php-config=/usr/local/php/bin/php-config \
--with-pdo-mysql=/usr/local/mysql
# 注意:
# --with-php-config 指向 php-config 路徑 (phpize 同目錄)
# --with-pdo-mysql 指向 MySQL 安裝根目錄 (含 include、lib)
若 make 報錯找不到 mysql.h,建立軟連結:
ln -s /usr/local/mysql/include/* /usr/local/include/
# 或指定完整路徑
export CPPFLAGS="-I/usr/local/mysql/include"
export LDFLAGS="-L/usr/local/mysql/lib"
make && make install
# 輸出提示安裝路徑,如:
# Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20190902/
; 1. 確認 extension_dir 指向 .so 所在目錄 (勿包含子目錄)
extension_dir = "/usr/local/php/lib/php/extensions/"
; 2. 啟用擴展 (Linux 下無 php_ 前綴,副檔名為 .so)
extension=pdo_mysql.so
; 3. 重啟 PHP-FPM / Apache
systemctl restart php-fpm
# 或
service httpd restart
php -m | grep pdo_mysql
# 或瀏覽 phpinfo() 頁面搜尋 pdo_mysql
PHP for Windows 官方發布包已內建 php_pdo_mysql.dll,無需另行編譯。
; php.ini
extension_dir = "C:/php/ext" ; 確認 ext 目錄路徑
extension=pdo_mysql ; PHP 7.2+ 可省略 .dll 後綴
; 舊版本可能需要
; extension=php_pdo_mysql.dll
啟用擴展後仍報錯,通常因缺少 libmysql.dll 或 libssl/libcrypto 於系統 PATH。
php.exe, libmysql.dll) 加入系統環境變數 PATH,重啟 Apache/命令行。libmysql.dll 複製到 C:/Windows/System32/ 或 Apache 的 bin/ 目錄。mysqlnd (MySQL Native Driver) 替代 libmysql,PHP 5.4+ 預設編譯,無需外部 DLL,配置 pdo_mysql.default_socket 即可。| 現象 | 可能原因 | 解決方案 |
|---|---|---|
| configure: mysql.h not found | MySQL devel 包未裝或路徑錯誤 | 安裝 mysql-devel / libmysqlclient-dev;指定 --with-pdo-mysql 路徑 |
| make: undefined reference to mysql_* | 链接庫缺失 | export LDFLAGS="-L/usr/local/mysql/lib -lmysqlclient" |
| PHP Warning: PHP Startup: Unable to load dynamic library 'pdo_mysql.so' | extension_dir 錯誤 / .so 檔案不存在 / 依賴庫缺失 | 修正 extension_dir;確認 .so 存在;ldd 檢查依賴 |
| Windows: could not find driver | libmysql.dll 不在 PATH | 加入 PHP 目錄到 PATH 或複製 DLL 到 System32 |
| 連接報錯 SQLSTATE[HY000] [2002] | Socket 路徑不匹配 | 見下文專文《PHP PDO 連接報錯 2002 解決方案》 |
yum install php-pdo php-mysqlnd 或 apt install php-pdo-mysql,自動處理依賴與更新。PDO::ATTR_EMULATE_PREPARES,使用真實預處理語句防止 SQL 注入。