phpMyAdmin 2.11.5.1 安裝配置全紀錄與三大常見錯誤排查

安裝步驟 (Windows + Apache + PHP 本地測試)

1. 官網下載 all-languages.zip，解壓至虛擬目錄 D:\www\phpmyadmin
2. 編輯 libraries/config.default.php (新版不再用根目錄 config.inc.php)
3. 核心配置項：

   $cfg['PmaAbsoluteUri'] = 'https://localhost/phpmyadmin/';  // 必須含 https:// 及尾部 /
   $cfg['Servers'][$i]['host'] = 'localhost';
   $cfg['Servers'][$i]['auth_type'] = 'cookie';              // 建議統一用 cookie 模式
   $cfg['blowfish_secret'] = 'your_random_string_46chars';   // cookie 模式必填，否則報錯
   $cfg['Servers'][$i]['user'] = 'root';
   $cfg['Servers'][$i]['password'] = 'your_mysql_pass';
   $cfg['DefaultLang'] = 'zh';                               // 簡體中文
   $cfg['DefaultCharset'] = 'gb2312';

4. 瀏覽器訪問 https://localhost/phpmyadmin/ 即可使用

三大經典錯誤與解決方案

錯誤 1：無法載入 mcrypt 擴展

現象：登入頁提示「Cannot load mcrypt extension」

排查清單：

1. MySQL 服務是否啟動 (檢查 mysqld-nt.exe 進程)
2. C:\Windows\System32 缺少 libmcrypt.dll → 從 PHP 目錄複製過去並重啟 Web 服務
3. php.ini 未啟用 extension=php_mcrypt.dll (去掉分號)
4. MySQL 資料目錄權限：Administrators/System 全控、Users 讀取/執行、刪除其他用戶
5. 環境變數新增 phpdir=C:\php (視實際路徑)

錯誤 2：配置文件需要 blowfish_secret

現象：已在 config.default.php 設定但仍報錯

真相：根目錄殘留舊版 config.inc.php，優先級高於 libraries/config.default.php

解決：刪除根目錄 config.inc.php 後重新整理即正常

錯誤 3：#2003 伺服器無回應

原因：MySQL 服務未啟動

解決：控制台 → 服務 → 啟動 MySQL；任務管理器確認 mysqld-nt.exe 存在

額外問題：Session 啟動失敗

現象：Cannot start session without errors

解決：

1. php.ini 設定 session.auto_start = 1
2. 建立 C:\php\tmp 目錄，session.save_path = "C:/php/tmp" 並去掉分號
3. 重啟 Apache

避坑提醒：網上許多教程誤導為 php_mbstring.dll 問題，實測無關。

版本升級注意

phpMyAdmin 2.11.x 以降配置檔遷移至 libraries/config.default.php，舊版 config.inc.php 會干擾新版讀取，全新安裝請勿保留舊配置檔。