phpMyAdmin 安裝與配置完整教學：從下載到資料庫管理

什麼是 phpMyAdmin？

phpMyAdmin 是一套以 PHP 撰寫的 MySQL 資料庫管理工具，提供直觀的 Web 介面，讓使用者無需記憶複雜的 SQL 指令，即可透過瀏覽器輕鬆管理資料庫、資料表與資料。對於不熟悉指令列操作的開發者或管理員而言，是不可或缺的利器。

安裝前準備

開始前，請確認伺服器已安裝並正常運行 Apache、PHP 以及 MySQL（或 MariaDB）。建議使用 XAMPP、WAMP 或 Laragon 等整合套件快速建立環境。

詳細安裝步驟

1. 下載與解壓縮

前往 phpMyAdmin 官網 下載最新穩定版壓縮包（建議選擇 .zip 格式）。將壓縮包解壓縮至 Web 根目錄下的任意資料夾，例如 htdocs/phpmyadmin（XAMPP 預設）或 www/phpmyadmin。

2. 配置檔案準備

進入解壓縮後的 phpmyadmin 目錄，尋找配置檔案：

• 若存在 config.sample.inc.php，將其重新命名為 config.inc.php。
• 若已有 config.inc.php，則無需更動。
• 若兩者皆無，請從 libraries/ 目錄複製 config.default.php 至根目錄並改名為 config.inc.php。

3. 修改核心配置 config.inc.php

使用支援 UTF-8 的編輯器（如 VS Code、Notepad++、Sublime Text）開啟 config.inc.php，重點設定以下兩項：

// 設定加密密鑰（cookie 認證模式下必填，任意字串即可）
$cfg['blowfish_secret'] = 'your_random_string_here'; // 例：'s3cur3_K3y_2024!'

// 設定認證類型
$cfg['Servers'][$i]['auth_type'] = 'cookie'; // 推薦：cookie / http / config(不安全)

說明： blowfish_secret 用於加密 Cookie，必須填寫且越複雜越安全；auth_type = 'cookie' 會彈出登入視窗，較 config 模式（免密直入）安全得多。

4. 進階配置選項（視需求調整）

同一檔案中，可進一步微調：

• MySQL 主機：$cfg['Servers'][$i]['host'] = 'localhost';（預設即可，遠端資料庫請填 IP）
• 連接埠：$cfg['Servers'][$i]['port'] = '';（空白代表預設 3306）
• 預設帳號/密碼：$cfg['Servers'][$i]['user'] = 'root'; / $cfg['Servers'][$i]['password'] = '';（僅 config 模式生效）
• 介面語言：$cfg['DefaultLang'] = 'zh_TW';（繁體中文）
• 限制顯示資料庫：$cfg['Servers'][$i]['only_db'] = 'your_db_name';（留空顯示所有）

驗證安裝

開啟瀏覽器，輸入 https://localhost/phpmyadmin/（依實際目錄調整），應會出現登入頁面。輸入 MySQL 的帳號密碼（預設 root / 空密碼），即可進入管理介面。

常見問題排除

• 「無法連線 MySQL 伺服器」：檢查 MySQL 服務是否啟動、host 設定是否正確、防火牆是否阻擋 3306 埠。
• 「blowfish_secret 不能為空」：確認 config.inc.php 中已設定非空字串。
• 權限錯誤：確保 config.inc.php 檔案權限為 644，目錄權限 755，且 Web 伺服器進程可讀取。

安全性建議

1. 將目錄重新命名為難以猜測的名稱（如 pma_sec_2024）。
2. 在 Apache/Nginx 層面加上 IP 白名單或 HTTP Basic Auth 雙重保護。
3. 定期更新 phpMyAdmin 至最新版本修補漏洞。
4. 生產環境嚴禁使用 config 認證模式。