在 ServBay 本地環境中安裝與設定 ExpressionEngine CMS
概述
ExpressionEngine 是一套功能強大且高度靈活的內容管理系統（CMS），廣泛應用於構建各類型的網站與 Web 應用。它擁有豐富的核心功能與高度模組化架構，讓開發者及設計師能夠自由打造並自訂網站。
ServBay 則是專為 macOS 打造的一站式本地 Web 開發環境，整合了多種主流 Web 伺服器（如 Nginx、Caddy、Apache）、程式語言執行環境（PHP、Node.js、Python、Go、Java、Ruby、Rust、.NET）、資料庫（MySQL、PostgreSQL、MongoDB、Redis），以及開發工具（Composer、npm/yarn、phpMyAdmin/Adminer）。藉由 ServBay，開發者可以輕鬆建置與管理本地開發環境。
本篇指南將詳盡說明如何在 ServBay 環境下安裝與設定 ExpressionEngine，協助您快速啟動 ExpressionEngine 專案。
為什麼選擇 ServBay 來安裝 ExpressionEngine？
使用 ServBay 在本地安裝 ExpressionEngine 具備以下優點：
- 環境整合性高： ServBay 已內建 ExpressionEngine 所需的 PHP 執行環境、MySQL 資料庫與網站伺服器，無需個別安裝設定。
- 多版本支援： 根據 ExpressionEngine 的版本需求，您可於 ServBay 中輕鬆切換並選用不同 PHP 版本。
- 資料庫管理方便： ServBay 內建 phpMyAdmin 或 Adminer，協助您便捷建立與管理 ExpressionEngine 需用的資料庫。
- 網站設定快速： 透過 ServBay 圖形介面，迅速建立指向 ExpressionEngine 專案目錄的本地網站。
- 專案環境隔離： 每個專案皆能擁有獨立網站設定，有效避免環境間衝突。
前置條件
開始安裝前，請確認已具備下列條件：
- 您的 macOS 系統已安裝並執行 ServBay。如尚未安裝，請前往 ServBay 官方網站 下載並依說明安裝。
- 熟悉基本終端機命令操作。
- 具備資料庫（如資料庫、使用者）之基礎概念。
- ServBay 的預設網站根目錄
/Applications/ServBay/www需具有寫入權限。
安裝步驟
請依照下列步驟，於 ServBay 環境中安裝並設定 ExpressionEngine。
步驟 1：建立專案目錄並下載 ExpressionEngine
首先，開啟您的終端機應用程式，切換至 ServBay 的預設網站根目錄 /Applications/ServBay/www，建立新的專案資料夾（如 servbay-ee-app），並進入該資料夾。
cd /Applications/ServBay/www
mkdir servbay-ee-app
cd servbay-ee-app2
3
接著，使用 curl 指令下載最新版 ExpressionEngine 至目前目錄。-L 參數可跟隨重新導向，-o 指定檔案名稱。
curl -L https://expressionengine.com/latest -o expressionengine.zip步驟 2：解壓 ExpressionEngine 安裝檔
下載完畢後，使用 unzip 指令解壓 expressionengine.zip 至目前 servbay-ee-app 目錄。解壓完成後，建議刪除壓縮檔。
unzip expressionengine.zip
rm expressionengine.zip2
解壓後，ExpressionEngine 的檔案結構即會出現在 servbay-ee-app 目錄內。
步驟 3：建立 ExpressionEngine 資料庫與使用者
ExpressionEngine 需一個資料庫以存放內容與設定。ServBay 內建 MySQL 與 phpMyAdmin，便於資料庫管理。
透過 ServBay 內建 phpMyAdmin 管理資料庫
請在瀏覽器中開啟 ServBay 的本地入口：
https://servbay.host/。在頁面中點擊「phpMyAdmin」連結，進入 phpMyAdmin 登入頁。請輸入 ServBay 提供的預設資料庫帳號密碼（通常預設無密碼即可登入localhost，更多細節可參考 ServBay 的資料庫設定頁）。建立專屬資料庫用戶及資料庫
登入 phpMyAdmin 後，將會為 ExpressionEngine 建立專用資料庫用戶及同名資料庫。
- 進入使用者帳號管理： 在 phpMyAdmin 首頁，點擊頂部選單「使用者帳號」。
- 新增使用者帳號： 點擊「新增使用者帳號」。
- 填寫帳號與資料庫資訊：
- 使用者名稱： 例如填入
ee_user。 - 主機名稱： 選擇
localhost（僅允許本機連線，增強安全性）。 - 密碼： 輸入安全的密碼作為 ExpressionEngine 連線用。請記下此密碼。例：
password123（僅作示範，建議實際使用強密碼）。 - 再次輸入密碼： 再輸入一次作確認。
- 同名資料庫建立： 勾選「建立與使用者名稱同名的資料庫並賦予所有權限」。如此將建立
ee_user資料庫且將所有權限授予該帳戶。
- 使用者名稱： 例如填入
- 檢查權限： 確認「全域權限」區域未勾選不必要的權限（因透過上述勾選已給予足夠的資料庫權限）。
- 執行： 點擊頁面底部「執行」按鈕完成建立。
至此，您已擁有名為
ee_user的資料庫，以及同名之使用者ee_user，該帳號擁有對該資料庫的完整權限。
步驟 4：於 ServBay 中設定網站
接著，需告知 ServBay 如何處理特定網域（如 servbay-ee.local）的請求，並指向 ExpressionEngine 專案。
開啟 ServBay 並新增網站
啟動 ServBay 應用程式的圖形介面。在左側選單中點選「網站」，再點選上方的「＋」或「新增」按鈕來建立新網站設定。
- 名稱 (Name)： 為網站命名，例如
My ExpressionEngine Site。 - 網域名稱 (Domain)： 輸入欲在本地存取的網域，如
servbay-ee.local。ServBay 會自動將此網域加入 hosts 檔，指向本機（127.0.0.1）。 - 網站類型 (Type)： 請選 PHP，因 ExpressionEngine 為 PHP 程式。
- PHP 版本 (PHP Version)： 依您下載之 ExpressionEngine 版本選取相容的 PHP 版本。ServBay 提供多種版本可切換。
- 網站根目錄 (Document Root)： 點選瀏覽，選擇第一步新建的專案目錄
/Applications/ServBay/www/servbay-ee-app。 - Web 伺服器 (Web Server)： 可任選 Nginx、Caddy 或 Apache 等，ServBay 會自動產生對應設定檔。一般本地開發建議用預設值即可。
- 名稱 (Name)： 為網站命名，例如
儲存與套用設定
所有資訊填寫無誤後，點選「儲存」或「套用」。ServBay 可能會提示需重新啟動 Web 伺服器以載入新設定，照畫面指示操作即可。
現在，當您在瀏覽器訪問
https://servbay-ee.local/，ServBay 便會將請求導向 ExpressionEngine 專案目錄。
步驟 5：啟動 ExpressionEngine 網頁安裝程式
ExpressionEngine 提供直覺的網頁安裝嚮導，協助您完成後續設定。
開啟安裝頁面
請於瀏覽器訪問您剛於 ServBay 設定之網域，加上 ExpressionEngine 安裝程式進入點
admin.php。預設安裝程式位於/admin.php。訪問網址：
https://servbay-ee.local/admin.php成功時您將看到 ExpressionEngine 歡迎頁或安裝嚮導畫面。
依嚮導填寫相關設定
ExpressionEngine 安裝嚮導會請您輸入下列主要資訊：
- 資料庫連線資訊：
- 資料庫主機 (Database Host)：
localhost - 資料庫名稱 (Database Name)：
ee_user（即步驟三新建之資料庫） - 資料庫使用者名稱 (Database Username)：
ee_user（同上） - 資料庫密碼 (Database Password)：請填創建
ee_user時設定之密碼。
- 資料庫主機 (Database Host)：
- 超級管理員帳戶： 建立 ExpressionEngine 後台最高權限帳號，請填寫使用者名稱、密碼與電子郵件，建議設較複雜密碼。
- 網站設定： 輸入網站名稱、URL 等基本資訊。
- 資料庫連線資訊：
完成安裝
請再次確認所有資料無誤，再點選「安裝」或操作嚮導畫面中對應按鈕。系統將自動建立必要資料表並完成初始化。
安裝結束後，系統通常會跳轉至後台登入頁或管理主控台。
步驟 6：安裝完成後基礎設定
完成程式核心安裝後，可依需求加裝外掛、模板或進一步設定。
登入 ExpressionEngine 後台
用安裝過程中建立的管理員帳號登入 ExpressionEngine 後台。通常可直接造訪
https://servbay-ee.local/admin.php，輸入帳號及密碼即可。安裝外掛（Plugin）
於 ExpressionEngine 後台，導航至「開發者 (Developer)」→「擴充套件 (Add-Ons)」→「外掛 (Plugins)」。可瀏覽或安裝所需插件以增強功能。
安裝與設定模板
前往「設計 (Design)」→「模板 (Templates)」，可於此建立模板群組、單一模板，並撰寫用以呈現內容的 HTML/CSS/EE 程式碼。
使用 ExpressionEngine 建置您的網站
現在，您已成功於 ServBay 環境下安裝並設定好 ExpressionEngine。可立即用其強大功能來建置與管理網站內容。以下為一些常見入門操作：
創建頻道及內容條目
ExpressionEngine 核心設計為「頻道」(Channels) 與「條目」(Entries)。頻道定義內容型態及結構，條目則是實際的內容。
- 新增頻道： 透過 ExpressionEngine 後台，「內容結構 (Content Structure)」→「頻道管理 (Channels)」，點選「新增頻道 (Create New Channel)」，輸入名稱、欄位群組等設定，按「儲存頻道 (Save Channel)」完成。
- 創建條目： 前往「內容 (Content)」→「發佈 (Publish)」，挑選剛剛創建的頻道，輸入標題、內容（依頻道定義欄位）及其它資料，再點「儲存 (Save)」。
設定網站導覽選單
網站導覽選單通常透過模板製作。
- 建立或編輯模板： 由「設計 (Design)」→「模板 (Templates)」裡頭，選定或新增用於導航的模板（例如於
site群組中新建nav模板）。 - 編寫導覽程式： 於模板中運用 ExpressionEngine 標籤語法查詢頻道內容，生成 HTML 導覽結構。
- 匯入至版型佈局： 於主佈局模板中，以
{% include 'site:nav' %}（採用 Blade 時）或適用標籤匯入導覽模板。
客製化小工具（Widgets/Sidebars）
如導航選單，側邊欄或「小工具」區域也常以獨立模板建立：
- 製作小工具模板： 於「設計 (Design)」→「模板 (Templates)」新增用於小工具顯示的模板（如
site:sidebar）。 - 撰寫小工具程式邏輯： 可顯示最新條目、分類列表、廣告等。
- 加入佈局版型： 於頁面佈局內將模板包含在合適位置。
常見問題 (FAQ)
- 問：進入
https://servbay-ee.local/顯示權限錯誤怎麼辦？- 答：請確認 ExpressionEngine 專案目錄（
/Applications/ServBay/www/servbay-ee-app）及其子目錄文件權限正確，ServBay 執行用戶（通常是您目前用戶）應擁有讀寫權限。可用chmod或chown指令調整，如：sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app。
- 答：請確認 ExpressionEngine 專案目錄（
- 問：安裝嚮導無法連線資料庫怎解？
- 答：請仔細檢查安裝嚮導設定的資料庫參數（如主機名
localhost、資料庫名稱、使用者、密碼）是否完全一致於 phpMyAdmin 中建立者，同時確認 ServBay 的 MySQL/MariaDB 服務已啟動。
- 答：請仔細檢查安裝嚮導設定的資料庫參數（如主機名
- 問：可否用 ServBay 其他資料庫（如 PostgreSQL）？
- 答：ExpressionEngine 主要支援 MySQL/MariaDB。若 ExpressionEngine 官方支援 PostgreSQL，且您能提供必要驅動與設定，理論上也可使用 ServBay 的 PostgreSQL，但需再確認 ExpressionEngine 官方文件所支持的資料庫型態。
總結
依據本指南操作，您應已成功於 ServBay 本地開發環境完成 ExpressionEngine CMS 的安裝與設定。ServBay 提供完善且便利的開發環境，整合所有必需元件。現在，就開始運用 ExpressionEngine 的強大功能來建構屬於您的網站或 Web 應用。祝您開發順利！