萬盛學電腦網

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

phpMyAdmin 安裝配置完整指南:從下載到常見錯誤排除

安裝前置準備

  1. 下載 phpMyAdmin 官方套件(phpmyadmin.net)
  2. 解壓至 Web 根目錄(如 /var/www/html/phpmyadmin 或虛擬主機 public_html)
  3. 可重命名資料夾(如 pma、dbadmin)提升安全性

核心配置:config.inc.php 設定詳解

建議複製 config.sample.inc.php 為 config.inc.php 並修改,而非直接改 libraries/config.default.php(升級時會被覆蓋)。

A. 絕對 URI(可選,現代版本自動偵測)

$cfg['PmaAbsoluteUri'] = 'https://example.com/phpmyadmin/'; // 結尾需含 /

B. MySQL 伺服器連線設定

$cfg['Servers'][$i]['host'] = 'localhost';     // 或 127.0.0.1、Socket 路徑
$cfg['Servers'][$i]['port'] = '3306';          // 非預設埠才需設定
$cfg['Servers'][$i]['user'] = 'root';          // 資料庫帳號
$cfg['Servers'][$i]['password'] = 'yourpass';  // 對應密碼

C. 認證模式選擇(關鍵安全設定)

模式適用場景安全性PHP SAPI 需求
cookie最推薦:表單登入、Session 管理高Apache 模組、CGI、FPM 皆可
http瀏覽器基本認證彈窗中僅 Apache 模組
config配置檔寫死帳密,免登入極低所有
signon單一登入(SSO)整合高需自行實作 signon URL
$cfg['Servers'][$i]['auth_type'] = 'cookie'; // 強烈建議

D. Blowfish 密鑰(cookie 模式必填)

$cfg['blowfish_secret'] = 'your_32_chars_random_string_here'; // 32 字元以上隨機字串

用於加密 Cookie 認證資料,不可留空,否則登入會報錯。可用 openssl_random_pseudo_bytes(32) 產生。

E. 語言與編碼

$cfg['DefaultLang'] = 'zh_TW';      // 繁體中文
$cfg['DefaultCharset'] = 'utf-8';   // 推薦 UTF-8,非 gb2312

常見錯誤與解決方案

1. 「缺少 mysqli 擴展」

// config.inc.php 中確認
$cfg['Servers'][$i]['extension'] = 'mysqli'; // PHP 7+ 預設 mysqli
// 若舊版 PHP 僅有 mysql 擴展(已棄用)
// $cfg['Servers'][$i]['extension'] = 'mysql';

檢查 php.ini 已啟用 extension=mysqli,並重啟 PHP-FPM/Apache。

2. 「PHP 5.3+ is required」

下載版本過新,PHP 版本過舊。解決:

  • 升級 PHP 至 7.4+(安全支援)
  • 或下載舊版 phpMyAdmin 4.x 分支(不建議,無安全更新)

3. 登入後白畫面/404

  • 檢查 $cfg['PmaAbsoluteUri'] 是否正確
  • 確認 Web 伺服器 DocumentRoot 指向正確路徑
  • 檢查 .htaccess / Nginx 重寫規則是否干擾

進階安全加固

  • 強制 HTTPS:$cfg['ForceSSL'] = true;
  • 限制存取 IP:Nginx/Apache 層面 allow 192.168.1.0/24; deny all;
  • 隱藏版本資訊:$cfg['VersionCheck'] = false;
  • 資料庫帳號最小權限:僅授予必要資料庫的 SELECT/INSERT/UPDATE/DELETE
  • 雙因子認證:安裝 twofactor_auth 外掛

Docker 一鍵部署(現代最佳實踐)

docker run -d \
  --name phpmyadmin \
  -e PMA_HOST=db \
  -e PMA_PORT=3306 \
  -e MYSQL_ROOT_PASSWORD=secret \
  -p 8080:80 \
  phpmyadmin/phpmyadmin:latest

官方映像內建最佳配置,自動處理認證、Session、SSL 等細節。

總結

phpMyAdmin 配置核心在於:正確的伺服器連線參數、安全的 cookie 認證模式、非空的 blowfish_secret。現代部署建議使用 Docker 官方映像,配合反向代理(Nginx/Traefik)啟用 HTTPS 與 IP 白名單,將管理介面與應用主機隔離,達到防禦纵深。

copyright © 萬盛學電腦網 all rights reserved