在 ServBay 中使用 phpMyAdmin 管理 MySQL/MariaDB 資料庫
概述:什麼是 phpMyAdmin
phpMyAdmin 是一款廣泛使用的開源資料庫管理工具,專為透過 Web 介面管理 MySQL 和 MariaDB 資料庫而設計。對於網頁開發者來說,它提供了直覺且易於上手的圖形化介面,大大簡化了資料庫日常管理任務,包括建立資料庫、資料表、使用者、執行 SQL 查詢,以及資料匯入匯出等。
ServBay 作為一套強大的本地 Web 開發環境,已經整合了 phpMyAdmin,讓您能輕鬆管理 ServBay 中運行的 MySQL 或 MariaDB 資料庫執行個體。
phpMyAdmin 具有以下幾個明顯優點:
- 功能完整:支援大多數 MySQL 和 MariaDB 的核心功能,涵蓋資料庫、資料表、欄位、索引、使用者權限等多元管理需求。
- 介面友善:提供明確的圖形化介面,即使是資料庫新手也能輕鬆上手。
- 多語言支援:支援多種語言界面,方便全球使用者操作。
- 易於擴展:可透過外掛或腳本擴充功能。
利用 phpMyAdmin,開發者能更專注於應用程式邏輯開發,而無需在命令列環境中耗費過多時間進行資料庫操作。
存取 ServBay 整合的 phpMyAdmin
ServBay 預設內建 phpMyAdmin,您可透過 ServBay 提供的本地訪問位址輕鬆開啟。
當 ServBay 運行時,請開啟您的網頁瀏覽器,並訪問以下網址:
https://servbay.host/phpmyadmin
請注意,servbay.host
是 ServBay 預設的本地域名,並經由 ServBay 內建的 Caddy/Nginx 伺服器解析,以呈現 ServBay 歡迎頁和各式整合工具(如 phpMyAdmin)。請確保 ServBay 已經啟動,並且相關的 Web 伺服器(如 Caddy 或 Nginx)以及資料庫套件(如 MySQL 或 MariaDB)都已啟用。
登入 phpMyAdmin
要開始管理資料庫,請使用正確憑證登入 phpMyAdmin。
- 開啟瀏覽器:訪問 phpMyAdmin 網址
https://servbay.host/phpmyadmin
。 - 輸入連線資訊:於登入頁面輸入用戶名稱及密碼。
- 用戶名稱與密碼:您可於 ServBay 應用介面中的 資料庫 (Databases) 分頁查找預設的資料庫用戶(通常為
root
)及其密碼。為提高安全性,建議首次使用後即變更 root 預設密碼。 - 伺服器:通常輸入
default
或選擇欲連結的特定資料庫版本(如MariaDB-10.6
或MySQL-8.0
)。default
通常指向 ServBay 目前預設啟用之資料庫版本。
- 用戶名稱與密碼:您可於 ServBay 應用介面中的 資料庫 (Databases) 分頁查找預設的資料庫用戶(通常為
- 登入:點選「登入」按鈕進入 phpMyAdmin 管理介面。
使用 phpMyAdmin 管理 ServBay 資料庫
成功登入 phpMyAdmin 後,您可以透過其圖形化介面執行各種資料庫管理操作。以下常見操作步驟供您參考:
建立新資料庫
為新專案建立獨立資料庫是最常見的起始步驟之一。
- 於 phpMyAdmin 左側導覽列點選 新建 或頁面中間的 資料庫 分頁。
- 在「建立資料庫」區段輸入欲建立的資料庫名稱(例如
servbay_project_db
)。 - 在「排序規則」下拉選單中,選擇合適的編碼與排序規則,通常建議選用
utf8mb4_unicode_ci
以支援更完整的字符集(包含 Emoji 表情)。 - 點選 建立 按鈕。
建立新資料表
資料庫建立完成後,您可以設定資料結構,也就是建立資料表。
- 於左側導覽列點選剛建立的資料庫名稱。
- 在該資料庫結構檢視中,找到「建立新資料表」區段。
- 輸入資料表名稱(例如
users
)及所需欄位數量。 - 點選 建立 按鈕。
- 在新頁面中設定每個欄位的屬性,包括:
- 名稱:欄位名稱(如
id
、username
、email
、created_at
)。 - 型別:資料型態(如
INT
、VARCHAR
、TEXT
、DATETIME
)。 - 長度/值:依據型態設定長度(如
VARCHAR(255)
)。 - 預設值:設定預設值(非必填)。
- 索引:可設為主鍵 (PRIMARY)、唯一鍵 (UNIQUE)、一般索引 (INDEX) 等,通常需為
id
欄位設 PRIMARY 並勾選 AUTO_INCREMENT。 - A_I:勾選此項目讓該欄位自動遞增(常用於主鍵)。
- 名稱:欄位名稱(如
- 欄位屬性設定完成後,請捲動至頁面底部,點選 儲存 按鈕。
插入資料
將新紀錄新增到資料表內。
- 於左側導覽列選擇欲插入資料的資料表。
- 點擊上方功能列 插入 分頁。
- 填寫要插入的欄位資料。您可同時插入多筆資料。
- 點選頁面底部的 執行 按鈕。
查詢與瀏覽資料
檢視資料表已有內容或執行自訂查詢。
- 於左側導覽列選擇要檢視的資料表。
- 點擊功能列上的 瀏覽 分頁,即可預覽資料表前數筆資料。
- 若需執行複雜查詢,可點選 SQL 分頁,輸入查詢語法(例如
SELECT * FROM users WHERE username = 'servbay-demo';
),再點選 執行。
更新資料
修改資料表現有紀錄內容。
- 於左側導覽列選擇欲更新的資料表。
- 點擊 瀏覽 分頁找到欲編輯的資料列。
- 在目標資料列旁點選 編輯(鉛筆圖示)。
- 編輯對應欄位內容後。
- 點選頁面底部的 執行 按鈕完成儲存。
刪除資料
從資料表移除特定紀錄。
- 於左側導覽列選擇要刪除資料的資料表。
- 點擊 瀏覽 分頁,找到要刪除的資料列。
- 在目標資料列左側方框勾選。
- 可多選多列一併刪除。
- 點選該行旁的 刪除(叉號圖示),或多選後於頁面底部選擇 刪除 再按 執行。
- 再次確認刪除操作。
刪除資料表
一次移除整個資料表及其所有資料。
- 於左側導覽列選擇目標資料庫。
- 在資料庫結構檢視中找到要刪除的資料表。
- 勾選欲刪除表的左側方框。
- 在資料表清單下方找到 刪除 並點選 執行。
- 確認刪除操作。請注意,此操作將永久清除該資料表的所有資料。
刪除資料庫
完整移除資料庫及其所有內容。
- 於左側導覽列選擇待刪除的資料庫。
- 點擊功能列上的 操作 分頁。
- 捲動至頁面底部,在「刪除資料庫 (Drop the database)」區塊點選 刪除資料庫 按鈕。
- 確認刪除操作。請注意,刪除資料庫為不可逆行為,數據將永久刪除。
常見問題 (FAQ)
- 問:為什麼無法訪問
https://servbay.host/phpmyadmin
?- 答:請確認 ServBay 應用已啟動,並在 ServBay 控制面板中開啟了 Web 伺服器(Caddy 或 Nginx)及相關資料庫套件(MySQL 或 MariaDB)。同時請檢查系統 hosts 檔是否被其他軟體影響,或嘗試重新啟動 ServBay。
- 問:該去哪裡查閱資料庫用戶名稱及密碼?
- 答:ServBay 預設的 root 帳號與密碼可於應用介面的 資料庫 (Databases) 分頁找到。詳情請參考文章 取得資料庫 root 帳號密碼與連線資訊
- 問:如果忘記 root 密碼怎麼辦?
- 答:ServBay 支援重置 root 密碼。您可於 ServBay 應用介面 資料庫 (Databases) 分頁找到重設按鈕。點擊後,ServBay 會自動為選定的資料庫(MySQL 或 MariaDB)產生預設 root 密碼並顯示於介面上。
- 問:phpMyAdmin 能連線 ServBay 的 PostgreSQL 或 MongoDB 嗎?
- 答:phpMyAdmin 僅設計用來管理 MySQL 和 MariaDB,不支援 PostgreSQL 或 MongoDB。
總結
利用 ServBay 整合的 phpMyAdmin,您可以更高效、直觀地管理本地開發環境內的 MySQL 及 MariaDB 資料庫。無論是建立或刪除資料庫、資料表,還是進行資料的新增、查詢、更新與刪除,phpMyAdmin 的圖形化介面都大幅降低了資料庫管理的門檻。結合 ServBay 所提供的便利環境管理功能,您將能更流暢地進行 Web 應用程式的開發與除錯。