WordPress 安裝中文亂碼終極解決：缺失 mysql.so 擴展

WordPress 安裝訪問 wp-admin/install.php 出現亂碼：

鎮ㄧ殑 PHP 浼間箮娌℃湁瀹夎杩愯 WordPress 蹇呴』鐨 MySQL 鎷撳睍

解碼後為：**「您的 PHP 環境沒有安裝運行 WordPress 所必需的 MySQL 擴展」**。根因：**PHP 僅載入 mysqli 擴展，WordPress 需要 mysql (舊版) 擴展**。

解決步驟

1. 在 PHP ext 目錄尋找 php_mysql.dll (Windows) 或 mysql.so (Linux)。
2. 複製到 PHP 根目錄 (Windows) 或確保擴展目錄正確 (Linux)。
3. 編輯 php.ini，取消註釋：extension=php_mysql.dll (Win) / extension=mysql.so (Linux)。
4. 重啟 Apache/Nginx-PHP-FPM。
5. 重新訪問安裝頁，亂碼消失，正常進入安裝向導。

深度排查邏輯

1. 亂碼實為 UTF-8 頁面被 GBK/Big5 解碼，說明 PHP 錯誤輸出編碼與頁面不一致。
2. 錯誤內容提示「MySQL 擴展缺失」，非連接參數錯誤（已核對 wp-config.php）。 3. 歷史項目常用 mysqli，但 WordPress 早期版本依賴 mysql 擴展（mysql_connect 等函數）。 4. 補裝 mysql 擴展即解決。

現代最佳實踐

• **PHP 7.0+ 已移除 mysql 擴展**，僅保留 mysqli 和 PDO_MySQL。
• WordPress 3.9+ 已全面支持 mysqli/PDO，**請升級 WordPress 而非降級 PHP**。
• 若必須舊版本，考慮 Docker 隔離舊環境：php:5.6-apache。

總結

中文亂碼往往是錯誤信息編碼顯示異常。**看清錯誤本質（缺擴展）比修復亂碼更重要**。現代部署請用 **PHP 7.4+ + WordPress 最新版 + mysqli/PDO**，徹底告別舊擴展坑。