在 ServBay 環境中安裝與配置 Bedrock

概述

本文件將引導您如何在 ServBay 本地開發環境中安裝並設定 Bedrock。Bedrock 提供現代化的 WordPress 專案架構，以 Composer 管理相依、優化設定管理，而且遵循最佳實踐，大幅提升 WordPress 專案的開發、佈署和維護效率與安全性。結合 ServBay 強大且操作簡易的本地環境管理能力，您將能夠迅速建立 Bedrock 開發環境。

什麼是 Bedrock？

Bedrock 是由 Roots 團隊開發的 WordPress 專案結構，目的是全面提升 WordPress 的開發體驗。與傳統 WordPress 架構相比，Bedrock 具有以下主要特點：

• 使用 Composer 管理相依套件： WordPress 核心、佈景主題與外掛皆可透過 Composer 管理，簡化更新與相依衝突處理。
• 改良的設定管理： 採用 Twelve-Factor App 原則，透過 .env 檔案管理環境變數，將設定與程式碼分離，更加安全且具彈性。
• 更佳的專案組織： WordPress 核心置於獨立子目錄（web/wp），主題與外掛則放在 web/app，結構更井然有序。
• 強化安全性： 預設包含安全強化措施，如隱藏核心程式路徑等。

Bedrock 是打造更健壯、可維護、現代化 WordPress 網站的理想選擇。

為什麼選擇 ServBay 來開發 Bedrock？

ServBay 是專為 macOS 打造的本地 Web 開發環境工具，整合了主流 Web 伺服器（Caddy/Nginx/Apache）、多重 PHP 版本、資料庫（MySQL/PostgreSQL/MongoDB），以及 Node.js、Python、Go、Java 等開發語言環境。搭配 Bedrock，您能輕鬆：

• 快速建置環境： ServBay 已預裝 Bedrock 所需的 PHP、Composer 與資料庫，免去繁瑣安裝流程。
• 彈性切換 PHP 版本： 輕鬆測試 Bedrock 在不同 PHP 版本的兼容性。
• 整合式資料庫管理： 用組內建 phpMyAdmin 或 Adminer 快速建立並管理 Bedrock 專用資料庫。
• 簡化網站設定： 使用 ServBay 圖形化介面快速配置 Bedrock 網站（虛擬主機），指向正確的網站根目錄。
• 集中化管理： 一站式管理所有本地開發必備的工具與網站。

前置條件

開始前，請確認以下準備事項：

• 已於 macOS 安裝並啟動 ServBay。
• 具備基礎指令列操作能力。
• 對 Composer 有初步了解（本文將提供明確指令）。

安裝 Bedrock 步驟

以下將逐步說明如何在 ServBay 中安裝並設定 Bedrock 專案。

步驟 1：建立專案資料夾

首先，移動至 ServBay 預設的網站根目錄 /Applications/ServBay/www，並在其中建立新專案資料夾。建議以具描述性的名稱命名，例如 servbay-bedrock-app。

cd /Applications/ServBay/www
mkdir servbay-bedrock-app
cd servbay-bedrock-app

此資料夾即為 Bedrock 專案的根目錄。

步驟 2：使用 Composer 建立 Bedrock 專案

ServBay 已內建 Composer，可直接開啟終端機並使用 composer 指令。在剛才建立的專案資料夾（/Applications/ServBay/www/servbay-bedrock-app）下，執行：

composer create-project roots/bedrock .

此指令將於目前資料夾（.）下載最新 Bedrock 版本及其相依套件。所需時間視網路狀況而定。

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

Bedrock（WordPress）須使用資料庫來儲存網站內容與設定。此處將透過 ServBay 內建的 phpMyAdmin 建立資料庫和專屬用戶。

1. 打開 ServBay 內建 phpMyAdmin 管理工具

   請於瀏覽器輸入 ServBay 預設網址 https://servbay.host/，於歡迎頁面點擊「phpMyAdmin」連結進入資料庫管理介面。

2. 建立資料庫用戶

   建議每個專案獨立建立資料庫用戶及資料庫以強化管理與安全性。

   1. 前往用戶帳號頁面

      於 phpMyAdmin 首頁，點擊上方選單的「使用者帳號」。

   2. 新增用戶帳號

      點選「新增使用者帳號」，並填寫下列資訊：

      • 使用者名稱： 例如 bedrock_user
      • 主機位置： 選擇 localhost，讓該用戶僅能本地連接
      • 密碼： 請使用安全密碼並記錄（如開發階段可先設為 password123，正式環境務必更強）
      • 再次輸入密碼： 重複輸入密碼

      在「資料庫為使用者建立」處，勾選「建立與使用者同名的資料庫並給予全部權限」。

      並勾選「給予全部權限」確保新用戶權限完整。

      最後點擊頁面下方「執行」完成建立。

步驟 4：配置 Bedrock

Bedrock 透過專案根目錄下的 .env 管理環境設定變數。

1. 複製並編輯環境設定檔

   在您的 Bedrock 專案根目錄（/Applications/ServBay/www/servbay-bedrock-app）內，可以找到 .env.example 範例檔。先複製並更名為 .env：

   cp .env.example .env

   .env 為實際生效的設定檔，.env.example 只供參考。

2. 編輯 .env 檔案

   使用您習慣的文字編輯器（VS Code、Sublime Text、Nano 等）開啟 .env，尋找與資料庫連線有關的配置並依照步驟 3 的資料填寫：

   # Database
   DB_NAME='bedrock_user' # 資料庫名稱，預設與用戶同名
   DB_USER='bedrock_user' # 資料庫用戶名稱
   DB_PASSWORD='password123' # 資料庫密碼
   DB_HOST='localhost' # 資料庫主機位置，ServBay 預設為 localhost
   DB_PREFIX='wp_' # 資料表前綴詞，可依需求修改
   
   # WordPress Environment
   WP_ENV='development' # 目前使用環境（development, staging, production）
   
   # Site URLs
   WP_HOME='http://servbay-bedrock.local' # 網站完整網址
   WP_SITEURL='${WP_HOME}/wp' # WordPress 核心所在網址

   請依您實際設定（特別是 DB_PASSWORD）做調整。

   WP_HOME 與 WP_SITEURL 定義網站於瀏覽器的造訪網址，servbay-bedrock.local 為常用本地開發網域，可視需求調整。WP_SITEURL 指向子目錄 web/wp。

   另外 .env 亦可擴充如常數、郵件等 WordPress 設定。

步驟 5：設定 Web 伺服器（ServBay 網站）

為使 ServBay Web 伺服器正確解析 Bedrock 專案，需於 ServBay 內新增一個網站（虛擬主機）。

1. 新增網站

   開啟 ServBay 應用程式，點擊左側「網站」標籤，再按「+」/「新增網站」建立網站設定，並填寫：

   • 名稱： 輸入識別用名稱（如 My Bedrock Site）
   • 網域名稱： 輸入 .env 內 WP_HOME 設定的網域（如 servbay-bedrock.local），ServBay 會自動設為本地映射
   • 網站類型： 選擇 PHP
   • PHP 版本： 選擇與 Bedrock 相容之 PHP 版本（建議最新穩定版）
   • 網站根目錄： 注意！ Bedrock 網站根目錄為 /Applications/ServBay/www/servbay-bedrock-app/web（非專案根目錄）

2. 儲存設定

   完成後按儲存，ServBay 會自動更新伺服器配置。若需重啟服務請照提示操作。

步驟 6：完成 WordPress 安裝

Bedrock 專案與網站已配置完成，接下來於瀏覽器進行 WordPress 安裝程序。

1. 造訪安裝頁面

   開啟瀏覽器，前往 .env 及 ServBay 設定的 WP_SITEURL，通常為 http://servbay-bedrock.local/wp。若設定無誤，會進入 WordPress 安裝精靈。

2. 填寫資料庫資訊

   依向導輸入先前建立的資料庫與用戶資訊：

   • 資料庫名稱： bedrock_user
   • 使用者名稱： bedrock_user
   • 密碼： 步驟 3 設定的密碼（如 password123）
   • 資料庫主機： localhost
   • 表格前綴詞： wp_（如無需求可預設）

   按「提交」，系統將測試資料庫連線。

3. 填寫網站資訊

   若連線成功，會進入網站資訊設定：

   • 網站標題： 自訂您的網站名
   • 管理員帳號： 建立管理員用戶名稱
   • 密碼： 為管理員設強密碼
   • 電子郵件： 請輸入管理員信箱
   • 搜索引擎可見性： 開發環境建議勾選「阻止搜索引擎索引本站點」

4. 完成安裝

   點選「安裝 WordPress」，安裝流程會自動建立資料表。成功後可見提示並進入管理後台。

步驟 7：安裝佈景主題與外掛（Composer 方式）

Bedrock 極力推薦用 Composer 管理主題與外掛，而非透過 WP 後台安裝。

1. 尋找佈景主題／外掛的 Composer 套件名稱

   多數熱門主題和外掛皆可於 Packagist（packagist.org）或 WordPress Packagist（wpackagist.org）查找，如 wpackagist-theme/twentytwentyone 或 wpackagist-plugin/wordpress-seo。

2. 使用 Composer 安裝

   於專案根目錄 /Applications/ServBay/www/servbay-bedrock-app 執行：

   安裝佈景主題：

   composer require wpackagist-theme/your-theme-name

   安裝外掛：

   composer require wpackagist-plugin/your-plugin-name

   請以實際包名取代 your-theme-name／your-plugin-name。Composer 會自動安裝至 web/app/themes 或 web/app/plugins 目錄。

3. 於 WordPress 後台啟用

   登入 WP 管理後台（http://servbay-bedrock.local/wp/wp-admin/），然後：

   • 佈景主題：點「外觀」→「主題」找到已安裝主題並啟用。
   • 外掛：點「外掛」→「已安裝外掛」找到外掛並啟用。

   Bedrock 雖也支援通過 WP 後台上傳 .zip 安裝，但 Composer 管理是現代、官方推薦方式。

使用 Bedrock 建置網站

您已於 ServBay 成功安裝與設定 Bedrock，接下來即可像一般 WordPress 建站，但能享有現代開發帶來的效率：

• 建立頁面與文章： 登入 WP 後台，於「頁面」、「文章」新增內容。
• 設定網站選單： 於「外觀」→「選單」管理網站導航。
• 自訂小工具： 「外觀」→「小工具」管理側邊欄等版位。
• 主題／外掛開發： 開發者可於 web/app/themes 與 web/app/plugins 目錄下開發自訂主題、外掛。
• 設定管理： 善用 .env 分別管理不同環境（開發、測試、正式）設定。

常見問題 (FAQ)

• 問：造訪 http://servbay-bedrock.local 出現 404 錯誤怎麼辦？
  • 答：請確認 ServBay 內網站網域與造訪之網域一致。
  • 答：檢查網站根目錄是否正確設為 /Applications/ServBay/www/servbay-bedrock-app/web。
  • 答：必須確認 ServBay Web 服務已啟動。
  • 答：檢查 .env 檔內 WP_HOME 是否正確。
• 問：造訪 http://servbay-bedrock.local/wp 出現資料庫連線錯誤怎麼辦？
  • 答：請核對 .env 內 DB_NAME、DB_USER、DB_PASSWORD、DB_HOST 是否與 phpMyAdmin 設定一致。
  • 答：確定 ServBay 的 MySQL 或主用資料庫服務運作中。
  • 答：檢查該用戶已獲資料庫完整權限。
• 問：為何安裝主題／外掛後於 WP 後台無法看到？
  • 答：若用 Composer 安裝，請確認是在專案根目錄執行 composer install 或 composer require 而且無錯誤。
  • 答：主題將安裝於 web/app/themes，外掛於 web/app/plugins，請確認檔案存在。
  • 答：進後台「外觀」→「主題」或「外掛」→「已安裝外掛」頁面找尋並啟用。
• 問：如何升級 Bedrock、WordPress 核心、主題或外掛？
  • 答：Bedrock 由 Composer 管理版本，只需於專案根目錄執行 composer update 更新所有相依，或用 composer update vendor/package-name 針對單一套件升級。升級完部分需於 WP 後台執行資料庫更新。

總結

依照上述流程，您已成功在 ServBay 本地環境架設 Bedrock 專案。結合 ServBay 簡易的環境管理及 Bedrock 現代化開發流程，您將能更有效率、更安全地開發及維護 WordPress 專案。現在就開始善用 Bedrock 優勢，打造您的下一個 WordPress 網站吧！