phpMyAdmin 是以 PHP 撰寫的 MySQL/MariaDB 資料庫管理工具,提供直觀的 Web 介面,讓使用者無需記憶複雜的 SQL 指令,即可透過瀏覽器完成資料庫建立、資料表操作、資料匯入匯出、使用者權限管理等工作。對於不熟悉命令列操作的開發者或管理員,是不可或缺的利器。
mysqli、mbstring、json、session 擴充/var/www/html/phpmyadmin 或虛擬主機 public_html/phpmyadmin)pma、dbadmin)phpMyAdmin 設定檔位於 config.inc.php(根目錄)或 libraries/config.default.php(舊版)。建議複製 config.sample.inc.php 為 config.inc.php 後修改。
$cfg['PmaAbsoluteUri'] = 'https://your-domain.com/phpmyadmin/';
若留空,phpMyAdmin 會嘗試自動偵測,但明確設定可避免重導向問題。
$cfg['Servers'][$i]['host'] = 'localhost'; // 主機名或 IP
$cfg['Servers'][$i]['port'] = ''; // 留空使用預設 3306
$cfg['Servers'][$i]['socket'] = ''; // Unix socket 路徑(如 /var/run/mysqld/mysqld.sock)
$cfg['Servers'][$i]['user'] = 'root'; // 資料庫帳號
$cfg['Servers'][$i]['password'] = 'your_password'; // 對應密碼
$cfg['Servers'][$i]['auth_type'] = 'cookie'; // 驗證模式(見下文)
| 模式 | 適用環境 | 安全性 | 說明 |
|---|---|---|---|
| config | 本機開發 | 低 | 帳密寫死在設定檔,免登入直接進入,嚴禁用於公開環境 |
| cookie | Apache / Nginx + PHP-FPM | 高 | 透過 Cookie 儲存加密憑證,支援多使用者登入登出,推薦生產環境 |
| http | Apache (mod_php) | 中 | 使用 HTTP Basic Auth,瀏覽器原生對話框,無法登出 |
| signon | 整合 SSO 系統 | 高 | 單一登入整合,需自行實作 signon 腳本 |
$cfg['blowfish_secret'] = 'your_32_chars_random_string_here'; // 32 字元以上隨機字串
用於加密 Cookie 儲存的認證資訊。可用 openssl_random_pseudo_bytes(32) 產生,或線上工具生成。切勿留空,否則登入會報錯。
$cfg['DefaultLang'] = 'zh_TW'; // 預設語言:繁體中文
$cfg['ServerDefault'] = 1; // 預設伺服器索引
$cfg['NavigationTreeEnableGrouping'] = true; // 導覽樹分組
$cfg['MaxRows'] = 50; // 每頁顯示筆數
$cfg['SaveDir'] = ''; // 匯出檔案儲存目錄(留空為瀏覽器下載)
$cfg['UploadDir'] = ''; // 匯入檔案上傳目錄
phpMyAdmin 部分進階功能(書籤、查詢歷史、資料表關係、PDF 結構圖等)需要專用資料表支援:
sql/create_tables.sql 至資料庫(通常命名為 phpmyadmin)CREATE USER 'pma'@'localhost' IDENTIFIED BY 'strong_password';
GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma'@'localhost';
config.inc.php 設定控制使用者:$cfg['Servers'][$i]['controluser'] = 'pma';
$cfg['Servers'][$i]['controlpass'] = 'strong_password';
$cfg['Servers'][$i]['pmadb'] = 'phpmyadmin';
$cfg['Servers'][$i]['bookmarktable'] = 'pma__bookmark';
$cfg['Servers'][$i]['relation'] = 'pma__relation';
$cfg['Servers'][$i]['table_info'] = 'pma__table_info';
$cfg['Servers'][$i]['table_coords'] = 'pma__table_coords';
$cfg['Servers'][$i]['pdf_pages'] = 'pma__pdf_pages';
$cfg['Servers'][$i]['column_info'] = 'pma__column_info';
$cfg['Servers'][$i]['history'] = 'pma__history';
$cfg['Servers'][$i]['table_uiprefs'] = 'pma__table_uiprefs';
$cfg['Servers'][$i]['tracking'] = 'pma__tracking';
$cfg['Servers'][$i]['userconfig'] = 'pma__userconfig';
$cfg['Servers'][$i]['recent'] = 'pma__recent';
$cfg['Servers'][$i]['favorite'] = 'pma__favorite';
$cfg['Servers'][$i]['users'] = 'pma__users';
$cfg['Servers'][$i]['usergroups'] = 'pma__usergroups';
$cfg['Servers'][$i]['navigationhiding'] = 'pma__navigationhiding';
$cfg['Servers'][$i]['savedsearches'] = 'pma__savedsearches';
$cfg['Servers'][$i]['central_columns'] = 'pma__central_columns';
$cfg['Servers'][$i]['designer_settings'] = 'pma__designer_settings';
$cfg['Servers'][$i]['export_templates'] = 'pma__export_templates';
.htaccess 或 Nginx allow/deny)限制僅允許管理 IP 存取 /phpmyadmin 路徑phpmyadmin、pma 等常見名稱,降低自動掃描攻擊風險$cfg['LoginCookieValidity'] = 1440;(秒,預設 1440 = 24 小時)原因:PHP 未啟用 mysqli 模組。
解決:編輯 php.ini,確認 extension=mysqli 未被註解,重啟 Web 伺服器。
檢查項目:
127.0.0.1 而非 localhost 避免 socket 問題)bind-address 設定是否允許外部連線解決:設定 32 字元以上隨機字串至 $cfg['blowfish_secret']。
調整 PHP 設定(php.ini):
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
max_input_time = 300
memory_limit = 256M
或使用命令列匯入:mysql -u root -p db_name < large_file.sql
瀏覽器訪問 https://your-domain.com/phpmyadmin/,應顯示登入頁面。輸入資料庫帳密登入後,左側導覽列顯示資料庫列表,即表示安裝成功。
phpMyAdmin 功能強大且成熟,妥善設定後能大幅提升資料庫管理效率。建議定期更新至最新版本以修補安全漏洞,並配合伺服器層級存取控制,確保資料庫管理介面不被惡意存取。