在 ServBay 環境中安裝與配置 WordPress

概述

WordPress 是一套功能強大且廣受歡迎的開源內容管理系統（CMS），以 PHP 和 MySQL 為基礎。它是全球領先的網站與部落格建置平台，擁有龐大的社群、豐富的外掛與主題生態系，非常適合從個人部落格到複雜的電子商務網站等各種專案建置。

ServBay 是一款專為 macOS 設計的本地 Web 開發環境，提供一站式解決方案，整合多版本 PHP、主流資料庫（如 MySQL、PostgreSQL、MongoDB）、Web 伺服器（Caddy、Nginx）及 Redis 等工具。運用 ServBay，開發者能輕鬆在本地建構隔離、彈性且高效能的開發環境，讓本地安裝與測試 WordPress 變得非常便捷。

本文將詳細引導你如何在 ServBay 環境中下載、安裝與設定 WordPress，助你快速啟動本地的 WordPress 開發作業。

前提條件

開始前，請確認你已經符合以下條件：

1. 你的 macOS 系統上已成功安裝並運行 ServBay。
2. ServBay 中至少已安裝並啟動一個 PHP 版本（WordPress 需 PHP 7.4 或以上）及 MySQL 或 MariaDB 資料庫套件。
3. 基本理解 Web 伺服器、資料庫概念及終端機指令操作。

安裝 WordPress 的步驟

以下是在 ServBay 環境中安裝及設定 WordPress 的詳細流程：

步驟 1：下載與解壓縮 WordPress

首先，我們需取得最新版 WordPress 程式檔案，並將其放置於 ServBay 設定的網站根目錄（/Applications/ServBay/www）下的子目錄中。

1. 切換至 ServBay 網站根目錄

   開啟終端機，執行下列指令切換至 ServBay 的預設網站根目錄：

   cd /Applications/ServBay/www

2. 下載最新版 WordPress

   使用 curl 指令下載最新版 WordPress 壓縮檔：

   curl https://wordpress.org/latest.tar.gz -o wordpress.tar.gz

3. 建立專案目錄並解壓 WordPress

   建立一個新目錄來存放你的 WordPress 網站檔案（如 servbay-wordpress-app），並將下載的壓縮包內容解壓至該目錄。--strip-components 1 參數會移除壓縮包中的頂層 wordpress 目錄，將內容直接解壓到指定路徑。

   mkdir servbay-wordpress-app
   tar zxf wordpress.tar.gz --strip-components 1 -C servbay-wordpress-app

   這時，WordPress 檔案就應位於 /Applications/ServBay/www/servbay-wordpress-app 目錄下。

步驟 2：建立資料庫與資料庫用戶

WordPress 需要一個資料庫來儲存所有內容和設定（如文章、頁面、留言、外掛設定等）。我們將在 ServBay 的資料庫系統中建立一個新資料庫以及一個專屬的存取帳號。

1. 進入 ServBay 內建資料庫管理工具

   ServBay 預設提供 phpMyAdmin 或 Adminer（依你 ServBay 設定而定）作為資料庫管理工具。開啟瀏覽器，造訪 ServBay 的首頁 https://servbay.host/，點擊頁面上的「phpMyAdmin」或「Adminer」連結，進入管理介面。

2. 登入資料庫管理工具

   以 ServBay 預設的資料庫 root 帳號與你於安裝 ServBay 時設定的 root 密碼登入。

3. 建立新資料庫

   在管理工具介面中，進行下列操作來新建資料庫：

   • 通常於左側導覽或首頁找到「新建」（New）或「建立資料庫」（Create database）選項。
   • 在「資料庫名稱」（Database name）欄位輸入名稱，如 servbay_wordpress_db。
   • 選擇字元集為 utf8mb4，排序規則（Collation）設為 utf8mb4_unicode_ci。這是 WordPress 推薦的設定，可支援更多字元，包括 Emoji。
   • 點擊「建立」（Create）按鈕。

4. 建立資料庫用戶並授權

   為安全起見，建議針對 WordPress 建立只擁有特定資料庫權限的專用用戶，避免直接使用 root。

   • 於管理工具中，導航至「用戶帳號」（User accounts）頁面。
   • 點選「新增用戶帳號」（Add user account）。
   • 輸入用戶詳細資訊：
     • 使用者名稱（User name）：輸入 wordpress_user。
     • 主機名稱（Host name）：選擇或填寫 localhost。
     • 密碼（Password）：輸入一組強式密碼。切勿使用弱密碼如 password123。建議使用密碼產生器產生複雜密碼，並記下，稍後會用到。例如使用佔位符 your_strong_password_here。
     • 再次輸入密碼（Re-type）：請再次輸入密碼。
   • 重要： 在「全域權限」（Global privileges）區段，請勿勾選「全選」（Check All）或「授予所有權限」（Grant all privileges）。僅需給予特定資料庫權限。
   • 點擊下方「執行」（Go）或「新增用戶」（Add user）按鈕。

   建立用戶後，需賦予其存取 servbay_wordpress_db 資料庫的權限：

   • 回到「用戶帳號」（User accounts）頁面。
   • 找到剛建立的 wordpress_user@localhost，點擊其對應的「編輯權限」（Edit privileges）。
   • 下拉至「特定資料庫權限」（Database-specific privileges）區塊。
   • 在「加入下列資料庫權限」（Add privileges to the following database）下拉選單選擇先前建立的 servbay_wordpress_db。
   • 點擊「執行」（Go）。
   • 在新頁面，勾選「全選」（Check All），賦予該帳號對該資料庫所有權限（資料、結構、管理權限）。
   • 點擊下方「執行」（Go）以儲存變更。

步驟 3：於 ServBay 設定網站

接下來，我們需告知 ServBay 如何處理對你的 WordPress 網域的請求，將其指向正確的網站目錄。

1. 開啟 ServBay 應用

   啟動 ServBay 應用程式。

2. 新增網站設定

   於 ServBay 介面左側點選「網站」（Websites）標籤，再點擊左下角「+」按鈕，選擇「新增網站」（Add Website）。

3. 填寫網站設定資訊

   在跳出的視窗中，填寫以下內容：

   • 名稱（Name）：輸入便於辨識的網站名稱，如 ServBay WordPress Dev。
   • 網域（Domain）：輸入你期望本地訪問的網域，如 servbay-wordpress.demo。ServBay 將自動建立並啟用本地存取。
   • 網站類型（Site Type）：選擇 PHP。
   • PHP 版本（PHP Version）：於下拉選單選擇一個適用於 WordPress 的 PHP 版本（建議選用 ServBay 提供的最新版，例如 PHP 8.x）。ServBay 支援多版本同時運行。
   • 網站根目錄（Site Root）：點擊資料夾圖示，選擇或手動輸入 WordPress 存放目錄：/Applications/ServBay/www/servbay-wordpress-app。

4. 儲存設定

   填妥後點選「儲存」（Save）。ServBay 會自動套用新設定，且可能提示重啟相關 Web 伺服器套件。請確認重啟。

   憑藉 ServBay 的自動設定，瀏覽 servbay-wordpress.demo 時，系統將自動生成與配置本地受信任的 SSL 憑證，實現 HTTPS 安全連線。

步驟 4：完成 WordPress 安裝精靈

此時，資料庫與網站設定都已就緒。最後，只需透過瀏覽器造訪你的本地域名，運行 WordPress 安裝精靈。

1. 造訪你的本地 WordPress 網站

   開啟瀏覽器，網址列輸入上一步所設定的網域，如 https://servbay-wordpress.demo。

2. 開啟 WordPress 安裝精靈

   設定無誤時，應會看到 WordPress 歡迎頁面，要求選擇語言。選擇後點「繼續」。

3. 輸入資料庫連線資訊

   接著，WordPress 會要求填寫資料庫資訊。請填入第 2 步所建立的資料庫與帳號資訊：

   • 資料庫名稱（Database Name）：servbay_wordpress_db
   • 使用者名稱（Username）：wordpress_user
   • 密碼（Password）：your_strong_password_here（請填第 2.4 步你設的實際密碼）
   • 資料庫主機（Database Host）：localhost
   • 資料表前綴（Table Prefix）：wp_（預設值，為安全起見可自訂如 sbwp_）

   點擊「提交」。若連線成功，WordPress 會提示你進行安裝程序。

4. 執行安裝

   點擊「執行安裝」（Run the installation）。

5. 填寫網站資訊

   依序完成以下基本設定：

   • 網站標題（Site Title）：填入你網站的名稱。
   • 使用者名稱（Username）：建立 WordPress 管理員帳號（請勿使用 admin，請選擇具辨識性的名稱）。
   • 密碼（Password）：設定管理員密碼。WordPress 會顯示密碼強度，請務必設定強密碼。
   • 電子郵件（Your Email）：輸入你的郵箱。
   • 搜尋引擎可見性（Search Engine Visibility）：本地開發建議勾選「建議搜尋引擎不索引本站」，避免本地網站被收錄。

6. 完成安裝

   填妥資料後，點擊「安裝 WordPress」按鈕。WordPress 會自動完成餘下安裝。

   安裝成功後，將出現提示頁與登入 WordPress 後台的連結。

使用 WordPress 建置網站

恭喜！你已於 ServBay 本地環境成功安裝並設定 WordPress。現在就可以開始探索其強大功能，並自在地建置你理想的網站！

登入 WordPress 後台（通常為 https://servbay-wordpress.demo/wp-admin/），你可進行下列常見管理：

• 安裝主題與外掛： 透過「外觀」→「主題」及「外掛」→「安裝外掛」調整網站外觀與增加功能。ServBay 本地環境可安心測試各種主題和外掛。
• 建立及編輯內容： 利用「文章」及「頁面」功能，管理部落格文章或靜態頁面。
• 設定導覽選單： 在「外觀」→「選單」建立網站結構。
• 自訂網站外觀： 可透過「外觀」→「自訂」或主題選項調整布局與樣式。

常見問題（FAQ）

• Q: 無法訪問 https://servbay-wordpress.demo，怎麼辦？

  • A: 請確認 ServBay 已運行，相關 Web 伺服器（Caddy/Nginx）及 PHP 套件已啟動。
  • 查閱 ServBay「網站」設定，確認網域拼寫、網站根目錄是否指到 /Applications/ServBay/www/servbay-wordpress-app，並選對 PHP 版本。
  • 嘗試清除瀏覽器快取或改用無痕模式存取。
  • 檢查 macOS 的防火牆設置是否阻擋了本地連線。

• Q: WordPress 安裝時出現資料庫連線錯誤？

  • A: 請仔細檢查你於安裝精靈中輸入的資料庫名稱、用戶名、密碼及資料庫主機（localhost）是否與你於 ServBay 資料庫管理工具建立的完全一致。
  • 確認 ServBay 的 MySQL 或 MariaDB 套件確實正在運行。
  • 檢核新建的資料庫帳號是否有存取 servbay_wordpress_db 的權限。

• Q: 可以在同一個 ServBay 中安裝多個 WordPress 網站嗎？

  • A: 當然可以！只需為每個網站重複步驟 1～4：將 WordPress 解壓於不同子目錄，分別建立獨立資料庫與帳號，並於 ServBay「網站」新增不同本地域名及對應根目錄。

• Q: ServBay 支援哪些適用於 WordPress 的 PHP 版本？

  • A: ServBay 支援多種 PHP 版本，你可依 WordPress 版本需求或開發需求自由選擇。通常推薦使用 WordPress 官方建議的最新版。

總結

依照本指南步驟，你已經於強大彈性的 ServBay 本地開發環境下，成功架設並啟用了第一個本地 WordPress 網站！善用 ServBay 整合的多元工具及多版本支援，能助你高效且自由地進行 WordPress 主題與外掛開發、功能測試或內容管理。希望這份說明能幫助你充分掌握 ServBay，展開精彩的 WordPress 本地開發之旅！