在 ServBay 本機開發環境中安裝與設定 Drupal

概述

Drupal 是一款功能強大、彈性高且可擴充的開源內容管理系統 (CMS)，廣泛應用於建置多元網站，從個人部落格、小型企業網站到企業集團門戶及複雜的 Web 應用程式。它提供豐富的內容編輯工具、細緻的用戶權限控制與強大的模組架構，非常適合追求高度自訂與高效能的開發者。

ServBay 是專為 macOS 設計的本機 Web 開發環境工具，內建主流 Web 伺服器（如 Caddy、Nginx）、多種程式語言執行環境（如 PHP、Node.js、Python、Go、Java 等）、資料庫（如 MySQL、PostgreSQL、MongoDB、Redis），以及 Composer、npm 等開發者工具。在 ServBay 上安裝與設定 Drupal，能夠為您打造穩定、方便且功能完整的本地開發平台。

本文將詳細介紹如何在 ServBay 環境中安裝及設定 Drupal，幫助您快速建立本地 Drupal 開發環境。

前提條件

在開始安裝 Drupal 前，請先確認以下條件均已滿足：

1. 已安裝並執行 ServBay： 請確定您已於 macOS 上成功安裝 ServBay，且 ServBay 正在正常運作。
2. 具備 ServBay 基本操作知識： 熟悉如何透過 ServBay 介面管理軟體套件、添加網站，以及存取內建工具（如 phpMyAdmin）。
3. 已啟用 PHP 與 MySQL/MariaDB： ServBay 預設內建多個版本 PHP 及 MySQL 或 MariaDB 資料庫。請確保您預計使用的 PHP 版本已啟用，且資料庫服務已啟動。
4. 已安裝 Composer： ServBay 已整合 Composer，這是現代 PHP 專案不可或缺的依賴管理工具。本教學將以 Composer 建立 Drupal 專案。

Drupal 安裝步驟

以下是在 ServBay 環境下安裝與設定 Drupal 的詳細步驟：

步驟 1：建立專案目錄

首先，請於 ServBay 的網站根目錄 /Applications/ServBay/www 下，為您的 Drupal 專案建立一個專屬子目錄。

打開終端機，執行下列指令：

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

這會在 /Applications/ServBay/www 目錄下建立名為 servbay-drupal-app 的資料夾，並切換進入該目錄。

步驟 2：用 Composer 建立 Drupal 專案

ServBay 已預設安裝 Composer，無須額外安裝。Drupal 官方建議以 Composer 進行專案建立與依賴管理。

在剛剛建立的 servbay-drupal-app 目錄下，執行以下 Composer 指令：

composer create-project drupal/recommended-project .

此指令會以 drupal/recommended-project 樣板，在目前目錄 (.) 下建立全新的 Drupal 專案。Composer 會自動下載 Drupal 核心程式以及相關依賴。所需時間依網路速度而異。

drupal/recommended-project 樣板會將所有可公開存取檔案（如 index.php、CSS、JavaScript 檔案等）放於名為 web 的子目錄。這是現代 Drupal 專案的標準結構，增強專案安全性。

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

Drupal 需有資料庫保存所有內容、設定及用戶資料。我們將利用 ServBay 附帶的 phpMyAdmin 工具建立資料庫與專用用戶。

1. 進入 ServBay 的 phpMyAdmin 資料庫管理工具

   開啟瀏覽器並前往 ServBay 的預設控制台網址：https://servbay.host/。在儀表板頁面中，找到並點擊「phpMyAdmin」連結（通常在「工具」或「資料庫」區段進入），即可進入 phpMyAdmin 介面。

   servbay.host 為 ServBay 為便於本地開發而設置的專屬網域，指向 ServBay 內部管理介面。

2. 建立資料庫用戶

   為強化安全性與權限控管，建議針對 Drupal 專案建立專屬資料庫用戶。

   • 進入用戶帳號頁面： 在 phpMyAdmin 首頁，點擊上方導航列的「用戶帳號」。
   • 新增用戶帳號： 點擊「新增用戶帳號」。
   • 填寫用戶資訊：
     • 用戶名： 輸入您想要的帳號名稱，例如 drupal_user。
     • 主機名稱： 選擇或輸入 localhost，僅允許從本機連線以提升安全性。
     • 密碼： 輸入一組安全性高的密碼。本例中的 password123 僅供演示，實際請使用密碼產生器產生強密碼。
     • 再次輸入密碼： 再次確認密碼。
   • 資料庫權限設定: 在「為用戶建立資料庫」區塊，勾選「建立與用戶名稱相同的資料庫並賦予所有權限」。這會自動建立一個同名資料庫（如 drupal_user），並授權該用戶完全操作此資料庫。
   • 全域權限： 請勿勾選「授予所有權限」全域權限（除非您非常清楚需求），基本上只需對自身資料庫擁有所有權限即可。
   • 執行： 確認資訊無誤後，點擊頁面右下角「執行」。

   此時，您已建立名稱為 drupal_user 的資料庫及資料庫用戶，該用戶擁有對 drupal_user 資料庫的全部權限。

步驟 4：設定 Web 伺服器（在 ServBay 中新增網站）

接著，您需於 ServBay 介面新增一個網站設定，將本機網域指向 Drupal 專案的 web 目錄。

1. 啟動 ServBay UI： 開啟 ServBay 應用程式介面。
2. 新增網站： 點選側邊欄「網站」分頁。
3. 點選新增按鈕： 在網站列表頁下方，點擊「+」或類似按鈕建立新網站設定。
4. 填寫網站資訊：
   • 名稱： 如 My Drupal Site 讓您容易辨識。
   • 網域： 輸入您欲於本地端訪問的 Drupal 網域，如 servbay-drupal.local。ServBay 支援 .local 網域，無需編輯 hosts 檔案。
   • 網站類型： 選擇 PHP。
   • PHP 版本： 下拉選單中選擇欲搭配 Drupal 使用的 PHP 版本。請參考您的 Drupal 版本官方文件確認對應相容的 PHP 版本。
   • 網站根目錄： 這一步十分重要，請指向含有 Drupal 入口檔 (index.php) 的子目錄。根據步驟二的專案結構，正確目錄為 /Applications/ServBay/www/servbay-drupal-app/web。
5. 儲存設定： 完成填寫後，點擊 ServBay 介面的「儲存」或相應按鈕，即可新增網站設定。ServBay 會自動重載 Web 伺服器，設定立即生效。

步驟 5：啟動 Drupal 安裝程式

此時，您已可在瀏覽器透過設定的本機網域啟動 Drupal 網頁版安裝流程。

1. 存取安裝畫面

   開啟瀏覽器並前往您於步驟四設定的本機網域，加上 /core/install.php 路徑：https://servbay-drupal.local/core/install.php。

   應可見到 Drupal 的安裝精靈頁面。

2. 選擇語言

   選擇站台預設語言，然後點擊「儲存並繼續」。

3. 選擇安裝設定

   選擇欲安裝的類型。通常建議選「標準」配置，以取得常用功能。點擊「儲存並繼續」。

4. 設定資料庫資訊

   安裝程式會提示您填寫資料庫連線資訊。請填入步驟三建立的資料庫設定：

   • 資料庫類型： 選擇 MySQL, MariaDB, Percona Server, or equivalent。
   • 資料庫名稱： 輸入 drupal_user。
   • 資料庫用戶名： 輸入 drupal_user。
   • 資料庫密碼： 輸入您在步驟三為 drupal_user 設定的密碼。
   • 資料庫主機： 輸入 localhost。
   • 進階選項： 除非資料庫使用非預設連接埠或特殊設定，通常可維持預設。

   輸入完畢後，點擊「儲存並繼續」。Drupal 會嘗試連接資料庫並匯入初始資料。

5. 輸入站台資訊

   成功連線資料庫後，安裝程式將要求您設定站台資訊：

   • 站台名稱： 您網站的標題。
   • 站台 Email： 發送通知用的郵件地址。
   • 管理員用戶名： Drupal 後台登入帳號。
   • 管理員密碼： 請設置強度高的管理員密碼。
   • 國家/地區： 選擇國別。
   • 時區： 配置時區。

   填寫完畢，點擊「儲存並繼續」。Drupal 將完成餘下安裝步驟，包括產生設定檔、寫入站台基礎資訊等。

6. 完成安裝

   安裝結束後，系統會自動導向剛建好的 Drupal 首頁。恭喜，您已在 ServBay 成功架設 Drupal！

步驟 6：安裝模組與佈景主題（進階了解）

Drupal 的豐富擴展性來自於其模組與主題生態。安裝完成後，您可依需求增強及客製網站。

1. 登入 Drupal 管理後台： 前往 https://servbay-drupal.local/user 或 https://servbay-drupal.local/admin，以步驟五設定的管理員帳密登入。
2. 安裝模組： 登入後，從管理選單選「擴充」（Extend），可搜尋並安裝更多模組以擴充網站功能。
3. 安裝主題： 前往「外觀」（Appearance），可安裝與設定新主題變更網站外觀。

安裝後的進階設定與應用

Drupal 安裝成功後，您便可開始利用核心功能建構您的網站。以下為新手常見的基礎操作：

建立內容類型與內容

Drupal 核心為內容類型，決定不同類別內容的結構（如文章、頁面等）。

1. 建立內容類型： 登入管理後台，導覽至「結構」->「內容類型」。可編輯現有的內容類型或點「新增內容類型」自訂欄位（例如標題、內文、圖片等）。
2. 建立內容： 前往「內容」->「新增內容」，選擇欲建立的內容類型，填入相關欄位，然後點擊「儲存並發布」。

配置導覽選單

選單讓網站架構清楚、導覽順暢。

1. 建立選單： 在後台「結構」->「選單」，可新增或編輯任一選單。
2. 新增選單項目： 編輯選單後，點擊「新增連結」，填寫連結名稱及路徑（如 /node/1 或外部網址），然後儲存。

自訂區塊佈局

區塊能在網站指定區域（如側邊欄、頁尾）顯示自訂內容。

1. 新增區塊： 後台「結構」->「區塊佈局」可見目前主題的各區域。您可將現有區塊（如選單、自訂內容）拖放至各區域。
2. 設定區塊： 點區塊旁的「設定」按鈕，可調整標題、顯示頁面、用戶角色權限等。

注意事項與常見問答 (FAQ)

• 如何調整 PHP 設定？ 若 Drupal 需啟用特殊 PHP 擴充或提升記憶體上限 (memory_limit)，可在 ServBay 介面「套件」頁找到對應 PHP 版本，點「設定」編輯 php.ini。修改後需重啟 PHP 服務（ServBay 通常會直接提示或自動處理）。
• 網站無法開啟怎麼辦？
  • 確認 ServBay 有正常執行。
  • 查閱 ServBay 網站設定是否正確，特別是網域名稱與網站根目錄，根目錄須指向 .../servbay-drupal-app/web。
  • 檢查 ServBay 內部 Web 伺服器（Caddy 或 Nginx）服務是否運作。
  • 確認目前瀏覽的是 https://servbay-drupal.local，安裝時路徑為 https://servbay-drupal.local/core/install.php。
• 資料庫連線失敗？
  • 請再次確認安裝流程輸入的資料庫名稱、用戶與密碼與 phpMyAdmin 內一致。
  • 資料庫主機應為 localhost。
  • 檢查 MySQL/MariaDB 已在 ServBay 運行。
• 安裝 Composer 依賴出錯？ 檢查網路狀況，確保 Composer 可連至 packagist.org。必要時清除 Composer 快取或升級 Composer（ServBay 會定期更新內建 Composer）。
• 檔案權限問題？ Drupal 需有權限寫入特定目錄（如 web/sites/default/files、web/sites/default/settings.php）。ServBay 預設以當前使用者執行，macOS 一般不會有權限困難，但若有困難，請檢查這些目錄的權限設定。

總結

依照本教學步驟，您已順利於 ServBay 本機開發環境安裝並設定 Drupal。ServBay 為 Drupal 開發提供便利、高效率且集成所需元件的平台。現在，您能利用 Drupal 強大功能開始網站建置，並在 ServBay 環境中完成本機開發、測試與偵錯。隨著更深入使用 Drupal，ServBay 的彈性讓您輕鬆切換 PHP 版本、管理多種資料庫與服務，滿足專案多樣化需求。