phpMyAdmin 配置文件需設定加密短語密碼的解決方案

phpMyAdmin 配置文件需設定加密短語密碼的完整解決方案

在使用 phpMyAdmin 管理資料庫時，經常會遇到「配置文件現在需要一個加密短語」的錯誤提示。這是因為 phpMyAdmin 的 Cookie 認證模式需要一個 blowfish 密鑰來加密登入資訊。本文將詳細說明在 Windows 和 Linux 環境下的完整解決步驟。

核心解決方法：設定 blowfish_secret

phpMyAdmin 的配置檔案 config.inc.php 中必須設定 $cfg['blowfish_secret'] 參數，這是一組任意的隨機字串，用於 Cookie 加密。

Windows 環境設定步驟

1. 找到 phpMyAdmin 目錄下的 config.inc.php 檔案
2. 若不存在，請將 config.sample.inc.php 重新命名為 config.inc.php
3. 編輯檔案，確認或新增以下設定：

<?php
$cfg['Servers'][$i]['auth_type'] = 'cookie';
$cfg['blowfish_secret'] = 'your_random_string_here'; // 自定義隨機字串，建議 32 字元以上
?>

Linux (CentOS) 環境設定步驟

1. 使用 vim 編輯系統安裝的配置檔：
   vim /usr/share/phpmyadmin/config.inc.php
2. 找到以下行：
   $cfg['blowfish_secret'] = ''; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */
3. 在等號後填入任意字串，例如：
   $cfg['blowfish_secret'] = 'pooy'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */
4. 儲存並重新啟動 Web 服務（Apache/Nginx）

注意事項

• 字串長度：建議使用 32 字元以上的隨機字串，提高安全性
• 權限問題：Linux 下修改檔案需 root 權限
• 快取清除：修改後需清除瀏覽器快取或重新啟動瀏覽器
• 多伺服器：若配置多台伺服器，每台都需獨立設定

常見問題排查

若設定後仍報錯，請檢查：

1. 配置檔語法是否正確（分號、引號）
2. phpMyAdmin 版本是否支援 Cookie 認證
3. PHP session 功能是否正常運作
4. 瀏覽器是否允許 Cookie

完成上述設定後，phpMyAdmin 即可正常使用 Cookie 認證登入，不再出現加密短語錯誤提示。