ServBay

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

繁體中文

English
简体中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

在 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 專案建立一個專屬子目錄。

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

bash
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 指令：

bash
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 版本、管理多種資料庫與服務，滿足專案多樣化需求。