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 環境中安裝與設定 Contao CMS ​

Contao 是一套功能強大的開源內容管理系統 (CMS)，特別適合打造中小型企業網站、入口網站或複雜的網頁應用。本指南將詳細說明如何於 macOS 上的 ServBay 本機 Web 開發環境中安裝與設定 Contao，協助您快速展開 Contao 專案的開發。

ServBay 提供一站式整合環境，內建 PHP、Composer、資料庫服務（如 MySQL/MariaDB、PostgreSQL）及 Web 伺服器（如 Caddy、Nginx、Apache），大幅簡化本機開發環境的建置。藉由 ServBay，您可以輕鬆滿足 Contao 的所有運行需求。

什麼是 Contao？ ​

Contao 是一款基於 PHP 的開源內容管理系統（CMS），以易用性、高度彈性和強大的後台管理見長。它具備豐富功能，包括細緻的權限管理、版本控制、多語系支援、響應式圖片處理及模組化架構，讓功能擴充變得輕鬆。Contao 的核心設計理念在於奠定堅實基礎，使開發者與設計師可輕鬆打造客製化網站，無需從零開始。

先決條件 ​

在開始安裝 Contao 前，請確保符合以下條件：

  1. 已安裝並執行 ServBay： 您需在 macOS 上安裝 ServBay，並確定 ServBay 已運作，且啟用相容版本的 PHP（Contao 對 PHP 版本有特定要求，請參考 Contao 官方文件 獲取最新需求）及所需資料庫服務（如 MySQL 或 MariaDB）。
  2. Composer： ServBay 已內建 Composer，無須額外安裝。
  3. 終端機操作權限： 您需能透過終端機執行 Composer 指令。

安裝 Contao 步驟說明 ​

本節將指引您在 ServBay 環境下，逐步安裝與設定 Contao。

步驟 1：建立專案目錄 ​

首先，至 ServBay 預設網站根目錄 /Applications/ServBay/www，建立 Contao 專案的新子目錄。

bash
cd /Applications/ServBay/www
mkdir servbay-contao-app
cd servbay-contao-app

我們將在 servbay-contao-app 目錄中安裝 Contao。

步驟 2：使用 Composer 建立 Contao 專案 ​

Contao 建議透過 Composer 安裝與管理。ServBay 已經整合 Composer，所以您可以於專案目錄執行下列指令建立 Contao 專案：

bash
composer create-project contao/managed-edition .

此指令會將 Contao Managed Edition 最新版本及所有相依套件下載到目前目錄 (.)。依網路速度，這個過程可能會需要一點時間。

Contao Managed Edition 說明： contao/managed-edition 為 Contao 官方發行版本，內含 Contao 核心與建議套件，並設定好標準專案結構。請注意，使用 managed-edition 安裝時，Contao 網站根目錄會是專案目錄下的 web 子目錄。

步驟 3：建立資料庫與使用者 ​

Contao 需要資料庫儲存內容與設定。ServBay 內建便利的資料庫管理工具，如 phpMyAdmin 或 Adminer 來協助建立資料庫與使用者。此處以 phpMyAdmin 為例：

  1. 存取 ServBay 內建的 phpMyAdmin 資料庫管理工具

    開啟 ServBay 的本機網址 https://servbay.host/，在頁面中尋找並點擊 phpMyAdmin 的連結。

  2. 建立資料庫使用者

    為安全起見，建議另為 Contao 專案建立一組專用資料庫使用者。

    a. 前往用戶帳號頁面

    於 phpMyAdmin 首頁，點選頂部選單的「使用者帳號」。

    b. 新增使用者

    點擊「新增使用者帳號」，並填寫以下資料：

*   **使用者名稱：** 輸入打算用於 Contao 資料庫連線的名稱，例如 `contao_user`。
*   **主機名稱：** 選擇 `localhost`，代表只允許本機連線，提升安全性。
*   **密碼：** 設定一組**強密碼**。請勿像 `password123` 這類簡單密碼，建議實際環境用密碼產生器建立複雜密碼。
*   **重新輸入密碼：** 再次輸入前述密碼。

在「為使用者建立資料庫」部分，通常可選擇「建立同名資料庫並給予所有許可權」，即會建立一個名為 `contao_user` 的資料庫並授權剛建立的 `contao_user` 全權管理。

*   務必勾選「給予所有許可權」。
*   點選頁面下方「執行」按鈕，完成使用者與資料庫的建立。

步驟 4：於 ServBay 中設定網站 ​

現在要在 ServBay 內建立站台配置，對應剛剛建立的 Contao 專案目錄。

  1. 開啟 ServBay 並新增網站

    開啟 ServBay 應用主畫面，點選左側「網站」標籤，按下「新增」建立新的網站設定。

  2. 填寫網站設定資訊

    • 名稱： 為網站取個好辨識的名稱，例如 My Contao Site。
    • 網域名稱： 設定一個本機開發專用網域，建議使用 .local 或 .servbay.demo 做結尾，例如 servbay-contao.local。ServBay 會自動將此網域導至本機。
    • 網站類型： 請選 PHP。
    • PHP 版本： 選擇符合 Contao 系統要求的 PHP 版本，請參考 Contao 官方文件。
    • 網站根目錄： 這一步極為重要。若專案用 Composer 安裝的 contao/managed-edition，Contao 的公開目錄（含 index.php）在專案下的 web 子目錄。這裡必須填完整路徑，指向 web：/Applications/ServBay/www/servbay-contao-app/web。

  3. 儲存設定

    填妥所有資訊後，點選 ServBay 畫面下方「儲存」按鈕，ServBay 會套用新網站設定。

步驟 5：執行 Contao 網頁安裝程式 ​

完成網站設定後，可透過瀏覽器啟動 Contao 的網頁安裝程式。

  1. 存取安裝頁面

    於瀏覽器輸入您在 ServBay 設定的網域名稱，並加上 /contao/install 路徑，例如：https://servbay-contao.local/contao/install。

    若一切設定正確，您將看到 Contao 的安裝頁面。

  2. 輸入資料庫資訊

    安裝程式將請您填寫資料庫連線資訊。請輸入步驟 3 剛建立的資料庫與使用者：

    • 資料庫主機： localhost
    • 資料庫名稱： contao_user（如您在 phpMyAdmin 選了建立同名資料庫）
    • 使用者名稱： contao_user
    • 密碼： 步驟 3 設定的密碼

  3. 建立後台管理員

    依網頁指示，設定 Contao 後台管理者帳號、密碼、電子郵件等資訊，密碼務必設強。

  4. 完成安裝

    依照畫面指示完成剩餘安裝步驟（如建立資料表）。點選「安裝」或「完成」等按鈕，安裝即告完成。

步驟 6：驗證安裝並登入後台 ​

安裝程式完成後，可檢查 Contao 是否正確運作，並嘗試登入後台。

  1. 瀏覽前台頁面

    於瀏覽器開啟設定的網域名稱，例如 https://servbay-contao.local/。應可看到 Contao 的預設歡迎頁或空白頁（依 Contao 預設），代表 Web 伺服器配置正確，前端可正常存取。

  2. 進入 Contao 管理後台

    前往 Contao 後台登入頁，預設為 https://servbay-contao.local/contao。

    請用步驟 5 設定的管理員帳號密碼登入。成功登入後，即可開始建置內容、安裝擴充套件與設定網站。

常見問題 (FAQ) ​

Q：存取 https://servbay-contao.local/ 或 https://servbay-contao.local/contao/install 時遇到錯誤怎麼辦？

A：

  • 檢查 ServBay 是否運作： 確認 ServBay 應用正在執行，且 PHP 與 Web 伺服器（Caddy 或 Nginx）啟動中。
  • 檢查 ServBay 網站設定： 再三確認您於 ServBay 建立的站台設定（網域名稱、網站類型、PHP 版本與網站根目錄）是否正確。請留意，contao/managed-edition 的根目錄應為專案的 web 目錄。
  • 檢查網域解析： ServBay 可自動解析 .local 網域。若用其他結尾或有解析問題，可嘗試重啟 ServBay 或檢查系統 hosts 檔（一般情況下 ServBay 會自動管理）。
  • 檢查 Web 伺服器日誌： 檢查 ServBay 附帶的 Web 伺服器日誌（Caddy 或 Nginx），通常會有更詳細的錯誤資訊。

Q：資料庫連線失敗怎麼辦？

A：

  • 檢查資料庫服務狀態： 確保 ServBay 的 MySQL/MariaDB 或 PostgreSQL 服務已啟動。
  • 檢查資料庫憑證： 仔細檢查您於 Contao 安裝程式輸入的資料庫主機（localhost）、資料庫名稱、使用者名稱與密碼是否與於 phpMyAdmin 設定一致。
  • 檢查資料庫使用者權限： 請確認所建的資料庫使用者對 Contao 資料庫擁有完整權限。

Q：安裝過程遇到權限錯誤怎麼解決？

A： Contao 安裝程式需要有權寫入某些目錄。雖然 ServBay 預設足以應付，但如遇到權限問題，您可於終端機為專案目錄設適當權限：

bash
cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # 將 your_username 替換為您的 macOS 用戶名稱
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao 可能需要對這些目錄有寫入權限

請謹慎使用 chmod 777，這在正式環境不安全，但開發階段解決權限問題很常見。

結論 ​

照著本指南操作，您應已成功於 ServBay 本機開發環境安裝並設定好 Contao CMS。ServBay 的整合平台大幅簡化 Composer 相依套件管理、資料庫建置與 Web 伺服器設定等程序，讓您能專注於 Contao 的開發。現可立即進入 Contao 後台製作內容、設計頁面、安裝擴充套件與主題，展開您的網站建置。

若需進一步了解 Contao 的使用與功能，請參閱 Contao 官方文件。