萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

phpMyAdmin 安裝與配置完整教學:從下載到 Web 管理 MySQL

什麼是 phpMyAdmin?

phpMyAdmin 是以 PHP 撰寫的 **MySQL/MariaDB Web 管理介面**,提供圖形化操作資料庫、資料表、資料、使用者權限、匯入匯出、SQL 執行等功能,適合不熟悉 CLI 指令的開發者與管理員。

安裝步驟

1. 取得程式碼

  • 官網:https://www.phpmyadmin.net/downloads/ (選擇 `phpMyAdmin-x.x.x-all-languages.zip`)
  • 解壓至 Web 可存取目錄,如 `/var/www/html/phpmyadmin/` 或虛擬主機 `public_html/phpmyadmin/`
  • 重命名目錄為不易猜測名稱 (如 `pma_abc123`) 稍增安全性。

2. 核心配置:config.inc.php

複製 `config.sample.inc.php` → `config.inc.php`,編輯關鍵項:

<?php
// 1. 絕對 URI (含協定、域名、路徑,結尾無斜線)
$cfg['PmaAbsoluteUri'] = 'https://example.com/pma_abc123';

// 2. 伺服器群組 (支援多伺服器)
$i = 0;
$cfg['Servers'][$i]['host'] = 'localhost'; // 或 127.0.0.1、Socket 路徑
$cfg['Servers'][$i]['port'] = '';          // 空白 = 預設 3306
$cfg['Servers'][$i]['socket'] = '';        // Unix socket 路徑 (如 /var/run/mysqld/mysqld.sock)
$cfg['Servers'][$i]['auth_type'] = 'cookie'; // 推薦:Cookie 認證
$cfg['Servers'][$i]['user'] = 'root';      // 登入用戶 (或留空由使用者輸入)
$cfg['Servers'][$i]['password'] = '';      // 密碼 (留空由使用者輸入)
$cfg['Servers'][$i]['connect_type'] = 'tcp'; // tcp / socket
$cfg['Servers'][$i]['compress'] = false;
$cfg['Servers'][$i]['AllowNoPassword'] = false; // 禁止無密碼登入

// 3. Blowfish 密鑰 (Cookie 認證必填,32 字元隨機字串)
$cfg['blowfish_secret'] = 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6'; // 請自行產生

// 4. 其他推薦設定
$cfg['DefaultLang'] = 'zh_TW';
$cfg['ServerDefault'] = 1;
$cfg['UploadDir'] = '';
$cfg['SaveDir'] = '';
$cfg['MaxRows'] = 50;
$cfg['ShowSQL'] = true;
$cfg['EnableLogging'] = true;
$cfg['ExecTimeLimit'] = 300;
$cfg['MemoryLimit'] = '256M';

認證模式詳細比較

auth_type運作方式安全性適用場景
cookie表單登入、Session 儲存加密憑證、支援登出高 (HttpOnly、可設 Secure)**生產環境首選**
http瀏覽器 Basic Auth 對話框中 (無登出機制、憑證緩存)簡單內網、API 測試
config設定檔寫死帳密、免登入直接進入**極低** (原始碼洩漏即全開)**嚴禁生產** 僅本地開發
signon單一登入 (SSO) 整合,由外部系統提供憑證高 (視 SSO 實作)企業內部整合

安全強化清單

  • [ ] 目錄重命名為隨機字串
  • [ ] `.htaccess` / Nginx `location` 限制 IP 存取 (僅管理員 IP)
  • [ ] 強制 HTTPS (HSTS、Secure Cookie)
  • [ ] `$cfg['AllowNoPassword'] = false`
  • [ ] `$cfg['LoginCookieValidity'] = 1440` (24 分鐘閒置登出)
  • [ ] `$cfg['CaptchaLoginPublicKey']` / `CaptchaLoginPrivateKey` 啟用 reCAPTCHA 登入保護
  • [ ] 定期更新 phpMyAdmin 至最新版 (修補 CVE)
  • [ ] 刪除 `setup/`, `examples/`, `test/` 等非必要目錄

常見問題排查

  • 「找不到 mysqli/mysqli 擴充」:PHP 安裝 `php-mysqli`、`php-mbstring`、`php-zip`、`php-gd`、`php-json`、`php-session`。
  • 「無法連線 MySQL」:檢查 `host`/`port`/`socket`、MySQL `bind-address`、防火牆、SELinux、使用者權限 (`GRANT ALL ON *.* TO 'pma'@'localhost')`。
  • 「blowfish_secret 不能為空」:設定 32 字元隨機字串。
  • 匯入大 SQL 逾時:調大 `ExecTimeLimit`、`MemoryLimit`、`post_max_size`、`upload_max_filesize`,或用 CLI `mysql < dump.sql`。

總結

phpMyAdmin 安裝核心:**解壓 → 設定 `config.inc.php` (host、auth_type=cookie、blowfish_secret) → 瀏覽器存取 → 以 DB 帳密登入**。**安全配置 (IP 限制、HTTPS、強密碼、定期更新) 與安裝同等重要**。

copyright © 萬盛學電腦網 all rights reserved