萬盛學電腦網

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

PHP PDO_MYSQL 擴展安裝全攻略:Linux 編譯與 Windows 配置詳解

前言

PDO (PHP Data Objects) 提供統一的資料庫存取介面,pdo_mysql 是連接 MySQL/MariaDB 的核心驅動。本文詳細記錄在 CentOS (Linux) 及 Windows 環境下,從原始碼編譯安裝、配置 php.ini 到常見問題排查的完整流程。

一、Linux (CentOS 6/7/8) 編譯安裝

1. 環境準備

# 安裝編譯工具鏈與 PHP 開發頭文件
yum install -y gcc make php-devel mysql-devel
# 或 Ubuntu/Debian
apt-get install -y build-essential php-dev libmysqlclient-dev

2. 下載並解壓源碼

# 方式 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

3. 生成配置腳本

/usr/local/php/bin/phpize
# 輸出應顯示 PHP Api Version、Zend Module Api No 等信息

4. 配置編譯參數 (關鍵步驟)

./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)

5. 解決 MySQL 頭文件找不到問題

若 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"

6. 編譯安裝

make && make install
# 輸出提示安裝路徑,如:
# Installing shared extensions: /usr/local/php/lib/php/extensions/no-debug-non-zts-20190902/

7. 配置 php.ini

; 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

8. 驗證安裝

php -m | grep pdo_mysql
# 或瀏覽 phpinfo() 頁面搜尋 pdo_mysql

二、Windows 環境配置

1. 官方預編譯 DLL

PHP for Windows 官方發布包已內建 php_pdo_mysql.dll,無需另行編譯。

2. 啟用擴展

; php.ini
extension_dir = "C:/php/ext"  ; 確認 ext 目錄路徑
extension=pdo_mysql            ; PHP 7.2+ 可省略 .dll 後綴
; 舊版本可能需要
; extension=php_pdo_mysql.dll

3. 解決「could not find driver」錯誤

啟用擴展後仍報錯,通常因缺少 libmysql.dll 或 libssl/libcrypto 於系統 PATH。

  • 方案一 (推薦): 將 PHP 安裝目錄 (含 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 foundMySQL 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 driverlibmysql.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 注入。
  • 配置連接池 (如 PHP-FPM + Persistent Connections) 提升高併發效能。
copyright © 萬盛學電腦網 all rights reserved