Windows 環境下升級 PHP MySQL 客戶端庫（libmysql.dll）完整步驟

適用場景

本教學以 MySQL 4.0.x + PHP 5 為例（PHP 4 升級較複雜，不在本文討論範圍）。目標：將 PHP 內建的 MySQL 客戶端庫更新至最新版，解決相容性或效能問題。

升級步驟

1. 下載 MySQL 原始碼

前往 MySQL Snapshots 下載對應版本原始碼包。

2. 編譯 libmysql.dll

• 解壓縮至任意目錄
• 用 Visual Studio 開啟 mysql.dsw
• 選擇 Release 版本，僅編譯 libmysql 專案
• 產出：libmysql.dll、libmysql.lib

3. 覆蓋 PHP 建置目錄中的庫檔

libmysql.dll → win32build/lib/dll/  (覆蓋)
libmysql.lib → win32build/lib/      (覆蓋)

4. 更新標頭檔與定義檔

從 MySQL 原始碼 include/ 複製下列檔案至 win32build/include/ 覆蓋：

• my_alloc.h
• mysql.h
• mysql_com.h
• mysql_version.h
• mysqld_error.h

並將 libmysql/libmysql.def 複製至 win32build/include/。

5. 重新編譯 PHP 並部署

• 重新建置 PHP
• 安裝 PHP 相關檔案至對應目錄
• 將 libmysql.dll 複製至 Windows 系統目錄（Win2000: C:\WINNT，Win2003: C:\Windows）

6. 驗證升級結果

• 重啟 Web 伺服器
• 瀏覽 phpinfo() 頁面
• 檢查 MySQL 客戶端版本 是否顯示為新版本號

注意事項

• 務必對應相同編譯器版本（VC6/VC9 等），否則可能導致 PHP 載入失敗
• 生產環境建議先在測試機驗證
• 若使用 PHP 7+，已改用 mysqlnd 內建驅動，無需手動更新 libmysql