萬盛學電腦網

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

phpMyAdmin 詳細安裝設定圖文教學(含常見錯誤排除)

什麼是 phpMyAdmin?

phpMyAdmin 是以 PHP 撰寫的 MySQL/MariaDB 資料庫管理工具,提供直觀的 Web 介面,讓使用者無需記憶複雜的 SQL 指令,即可透過瀏覽器完成資料庫建立、資料表操作、資料匯入匯出、使用者權限管理等工作。對於不熟悉命令列操作的開發者或管理員,是不可或缺的利器。

安裝前置準備

  • 已安裝並正常運行的 Web 伺服器(Apache / Nginx)
  • PHP 環境(建議 7.4+),並啟用 mysqli、mbstring、json、session 擴充
  • MySQL / MariaDB 資料庫伺服器

步驟一:下載與部署

  1. 前往官網 phpMyAdmin 下載頁面,選擇 all-languages 版本(含繁體中文)
  2. 解壓縮至 Web 伺服器可存取的目錄(如 /var/www/html/phpmyadmin 或虛擬主機 public_html/phpmyadmin)
  3. 可依喜好重命名資料夾(例如 pma、dbadmin)

步驟二:核心設定檔配置

phpMyAdmin 設定檔位於 config.inc.php(根目錄)或 libraries/config.default.php(舊版)。建議複製 config.sample.inc.php 為 config.inc.php 後修改。

A. 設定絕對 URI(選填)

$cfg['PmaAbsoluteUri'] = 'https://your-domain.com/phpmyadmin/';

若留空,phpMyAdmin 會嘗試自動偵測,但明確設定可避免重導向問題。

B. 資料庫伺服器連線設定

$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';      // 驗證模式(見下文)

C. 選擇驗證模式(auth_type)

模式適用環境安全性說明
config本機開發低帳密寫死在設定檔,免登入直接進入,嚴禁用於公開環境
cookieApache / Nginx + PHP-FPM高透過 Cookie 儲存加密憑證,支援多使用者登入登出,推薦生產環境
httpApache (mod_php)中使用 HTTP Basic Auth,瀏覽器原生對話框,無法登出
signon整合 SSO 系統高單一登入整合,需自行實作 signon 腳本

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['ServerDefault'] = 1;               // 預設伺服器索引
$cfg['NavigationTreeEnableGrouping'] = true; // 導覽樹分組
$cfg['MaxRows'] = 50;                    // 每頁顯示筆數
$cfg['SaveDir'] = '';                    // 匯出檔案儲存目錄(留空為瀏覽器下載)
$cfg['UploadDir'] = '';                  // 匯入檔案上傳目錄

步驟三:建立儲存空間資料庫(進階功能啟用)

phpMyAdmin 部分進階功能(書籤、查詢歷史、資料表關係、PDF 結構圖等)需要專用資料表支援:

  1. 匯入 sql/create_tables.sql 至資料庫(通常命名為 phpmyadmin)
  2. 建立專用控制使用者並授權:
CREATE USER 'pma'@'localhost' IDENTIFIED BY 'strong_password';
GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma'@'localhost';
  1. 於 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';

步驟四:權限與安全性強化

  • 限制存取 IP:在 Web 伺服器層級(Apache .htaccess 或 Nginx allow/deny)限制僅允許管理 IP 存取 /phpmyadmin 路徑
  • 強制 HTTPS:確保登入憑證傳輸加密
  • 修改預設路徑:避免使用 phpmyadmin、pma 等常見名稱,降低自動掃描攻擊風險
  • 設定登入逾時:$cfg['LoginCookieValidity'] = 1440;(秒,預設 1440 = 24 小時)

常見錯誤與解決方案

錯誤 1:「缺少 mysqli 擴充」

原因:PHP 未啟用 mysqli 模組。

解決:編輯 php.ini,確認 extension=mysqli 未被註解,重啟 Web 伺服器。

錯誤 2:「無法連線 MySQL 伺服器」

檢查項目:

  • 主機名/ IP 是否正確(本機可用 127.0.0.1 而非 localhost 避免 socket 問題)
  • 連接埠是否為 3306(或自訂埠號)
  • 防火牆/安全群組是否放行該埠號
  • MySQL bind-address 設定是否允許外部連線

錯誤 3:「Blowfish secret 過短或未設定」

解決:設定 32 字元以上隨機字串至 $cfg['blowfish_secret']。

錯誤 4:匯入大型 SQL 檔案失敗

調整 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 功能強大且成熟,妥善設定後能大幅提升資料庫管理效率。建議定期更新至最新版本以修補安全漏洞,並配合伺服器層級存取控制,確保資料庫管理介面不被惡意存取。

copyright © 萬盛學電腦網 all rights reserved