在 macOS 的 ServBay 環境中安裝與設定 Joomla CMS

概述

本指南將詳細說明如何在 ServBay 這個功能強大的本機網頁開發環境中，安裝與設定 Joomla 內容管理系統（CMS）。ServBay 為 PHP、MySQL 等技術棧提供整合且便利的架設環境，非常適合架設與測試 Joomla 網站。您可透過 ServBay 輕鬆管理不同 PHP 版本、資料庫及網頁伺服器（Caddy 或 Nginx），為 Joomla 開發帶來彈性且高效率的基礎。

什麼是 Joomla？

Joomla 是一個廣受歡迎的開源內容管理系統（CMS），採用 PHP 編寫並通常搭配 MySQL 資料庫。它功能豐富且高度可擴充，適合用來建構從個人部落格、小型企業網站到大型企業入口網站和電商平台等各類型網站。Joomla 擁有龐大的社群支援與豐富的擴充功能及佈景主題資源，讓網站開發、管理與維護更加輕鬆高效。

應用情境

在本機 ServBay 環境架設 Joomla 網站進行開發、測試與除錯。
學習和探索 Joomla 各項功能及擴充套件開發。
離線狀態下進行 Joomla 專案作業。
為未來部署至正式環境預先設定好 Joomla 組態。

先決條件

在開始安裝 Joomla 前，請先確認您已具備下列條件：

已安裝並執行 ServBay： 請確保您已在 macOS 上安裝並啟動 ServBay。ServBay 會提供您所需的 PHP、網頁伺服器（Caddy 或 Nginx）及資料庫（MySQL 或 MariaDB）環境。
基本終端機操作知識： 安裝流程中將需透過終端機執行部分基本指令。
網路連線： 下載 Joomla 安裝檔時需有網路連線。

Joomla 安裝步驟

依照下列步驟，在您的 ServBay 環境中完成 Joomla 的安裝與設定。

步驟 1：下載 Joomla

首先，移動到 ServBay 預設推薦的網站根目錄 /Applications/ServBay/www。這是集中管理所有本機網站專案的方便地點。請在此目錄下建立新的專案資料夾給即將架設的 Joomla 網站，並下載 Joomla 安裝包。

bash

# 進入 ServBay 的網站根目錄
cd /Applications/ServBay/www

# 建立一個新的專案資料夾，例如 servbay-joomla-app
mkdir servbay-joomla-app

# 進入新建立的專案資料夾
cd servbay-joomla-app

# 下載 Joomla 安裝包
# 注意：下列連結可能指向較舊的 Joomla 3 版本。
# 建議造訪 Joomla 官方網站 (https://downloads.joomla.org/) 取得最新穩定版下載連結。
curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip

注意： curl -L https://downloads.joomla.org/cms/joomla3/latest-stable -o joomla.zip 這個連結在撰寫時可能指向 Joomla 3 最新穩定版。Joomla 官方不定期會發佈新版本（如 Joomla 4 或 5）。為獲得最新功能與安全強化，強烈建議您造訪 Joomla 官方下載頁面，確認並複製目前最新穩定版本的下載連結，替換上述指令的 URL。

步驟 2：解壓 Joomla

接著，將下載完的 Joomla 壓縮檔解壓縮到目前的 servbay-joomla-app 目錄，最後刪除壓縮檔保持目錄整潔。

bash

# 解壓 Joomla 壓縮檔
unzip joomla.zip

# 刪除壓縮檔
rm joomla.zip

解壓完成後，servbay-joomla-app 資料夾下將會包含 Joomla 所有安裝檔案。

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

Joomla 需使用資料庫來儲存內容、組態與用戶資料。我們將透過 ServBay 內建的 phpMyAdmin 工具來建立資料庫及對應的使用者。

開啟 ServBay 控制面板
於瀏覽器輸入 ServBay 的本機控制面板網址：https://servbay.host/。這是 ServBay 提供的便捷入口，可直接存取 phpMyAdmin、phpinfo 等工具。
進入 phpMyAdmin
在 ServBay 控制面板畫面，點選「phpMyAdmin」連結以進入資料庫管理界面。
新增資料庫使用者
為提升安全性，建議每個應用獨立建立一組資料庫用戶。
1. 導航至用戶帳號管理
  於 phpMyAdmin 上方功能列點選「用戶帳號」。
2. 新增用戶帳號
  點擊「新增用戶帳號」，並填寫以下資訊：
  - 使用者名稱： 輸入您想建立的資料庫用戶名稱，例如 servbay_joomla_user。
  - 主機名稱： 選擇 localhost，代表此用戶只能自本機連線，提升安全。
  - 密碼： 請設定強密碼，並妥善保存。例如此處以 password123 作為示範（實際使用時請務必換成複雜密碼）。
  - 重複輸入密碼： 再輸入一次欲設定的密碼以確認。
  - 為使用者建立資料庫： 勾選「建立與使用者名稱相同的資料庫並賦予所有權限」，系統將自動以用戶名建立資料庫（如 servbay_joomla_user），並賦予該用戶完全管理權限。
  - 全域權限： 切勿勾選「賦予全域所有權限」。我們僅希望此用戶只管理他自己的資料庫。
3. 確認建立
  檢查所有設定後，點選頁面底部的「執行」按鈕完成用戶及資料庫的建立。

步驟 4：設定網頁伺服器（新增網站）

您現在需要告訴 ServBay 如何用某個網域名稱來存取 Joomla 檔案，這透過在 ServBay 中新增一個「網站」組態來辦到。

開啟 ServBay 應用程式
啟動或切換至 ServBay 的應用程式介面。
前往網站管理
點選 ServBay 左側導覽欄的「網站」分頁。
新增網站
點選右上角的「新增」按鈕。
- 名稱 (Name): 輸入此網站的識別名稱，例如 My ServBay Joomla Site。
- 網域名稱 (Domain): 輸入您想在瀏覽器存取此網站時使用的本機網域，例如 servbay-joomla.local。ServBay 會自動處理本地 DNS 指向您的本機專案。
- 網站型態 (Site Type): 選擇 PHP。
- PHP 版本 (PHP Version): 選擇您欲供 Joomla 運行的 PHP 版本。請依您下載的 Joomla 版本相容性需求選擇合適版本。
- 網站根目錄 (Site Root): 點選旁邊檔案夾圖示，並選擇於步驟 1 建立的專案資料夾 /Applications/ServBay/www/servbay-joomla-app。
儲存設定
所有資訊確認填寫正確後，點選底部的「儲存」按鈕。ServBay 會立即套用新網站設定，過程中可能會略為重啟相關服務（如 Caddy 或 Nginx）。

步驟 5：執行 Joomla 安裝流程

此刻，您就可以透過剛設定的本機網域名稱，進入 Joomla 的網頁安裝流程。

存取安裝頁面
開啟您常用的瀏覽器，輸入於步驟 4 設定的網域，例：https://servbay-joomla.local/。ServBay 所設定的網頁伺服器會將請求導向指定之根目錄。Joomla 通常會自動偵測首次存取並導向安裝精靈頁面（通常為 /installation/index.php）。如未自動跳轉，可手動進入：https://servbay-joomla.local/installation/index.php。
依指示完成安裝精靈
這時會看到 Joomla 圖形化安裝介面。請依螢幕上的提示操作：
- 組態 (Configuration): 填寫站點基本資訊（例如站點名稱、說明、管理員帳號（帳號、密碼、E-mail）等）。請務必設定安全的管理員帳號與密碼。
- 資料庫 (Database): 在資料庫設定步驟，填入於步驟 3 所建立的資料庫連線資訊：
  - 資料庫類型 (Database Type): 通常選 MySQLi。
  - 主機名稱 (Host Name): 輸入 localhost。
  - 用戶名稱 (Username): 輸入資料庫用戶名稱，例如 servbay_joomla_user。
  - 密碼 (Password): 輸入該資料庫用戶密碼，例如 password123。
  - 資料庫名稱 (Database Name): 輸入建立的資料庫名稱，例如 servbay_joomla_user。
  - 資料表前綴 (Table Prefix): 可用預設隨機前綴，或自訂（如 jos_）。
  - 舊資料庫處理 (Action on Old Database): 若是全新安裝，選「備份」或「刪除」皆可，若資料庫是空的則差異不大。
- 總結 (Finalisation): 請再次確認所有設定，Joomla 會檢查環境是否符合需求。若一切正常，點選「安裝」繼續。
完成安裝並移除安裝資料夾
安裝過程可能需幾分鐘，完成後 Joomla 會提示您安裝結束。**請務必移除 installation 目錄，以確保安全性，防止他人重新啟動安裝流程。**Joomla 介面上通常會有一個按鈕提示您自動刪除。
或者您也可於終端手動刪除：
bash
```
# 進入 Joomla 專案資料夾
cd /Applications/ServBay/www/servbay-joomla-app

# 刪除 installation 目錄
rm -rf installation
```
1
2
3
4
5
刪除 installation 資料夾後，您的 Joomla 網站即可正常使用，可以選擇進入前台或管理後台。

步驟 6：探索 Joomla 管理後台

在您的網站網域後加 /administrator，例如 https://servbay-joomla.local/administrator，使用安裝時設定的管理員帳號與密碼登入 Joomla 管理後台。於此可開始網站設定、安裝擴充套件及佈景、管理內容等。

用 Joomla 建站入門（簡介）

成功安裝 Joomla 後，您就能發揮其強大功能進行網站建置。以下為幾項入門操作簡述：

創建文章與分類： 可在「內容」選單下管理文章和分類。
管理選單： 於「選單」選單下建立及編輯網站導覽選單。
設定模組： 在「擴充」->「模組」設定網站側邊欄、頁腳等功能模組。
挑選與自訂版型： 於「擴充」->「樣板」更改網站外觀，並可自訂樣式。
安裝擴充套件： 在「擴充」->「管理」上傳及安裝新元件、模組、外掛與主題，擴展 Joomla 功能。

注意事項

安全性： 管理員帳號及資料庫用戶請務必設強密碼，安裝完成後請立即移除 installation 目錄。
PHP 版本相容性： 請確認您於 ServBay 為 Joomla 網站選用的 PHP 版本，與安裝的 Joomla 版本相容。詳細相容資訊參閱 Joomla 官方文件。
資料庫連線資訊： Joomla 安裝時需正確填寫資料庫主機（localhost）、用戶名稱、密碼及資料庫名稱。
ServBay 更新： 建議定期將 ServBay 更新至最新版，以取得最新套件、安全修正與功能優化。
備份： ServBay 提供手動與自動備份功能，涵蓋網站檔案、資料庫、SSL 憑證及主程式設定。建議於重大更新與平日定期備份 Joomla 全站及資料庫，以防資料遺失。可於 ServBay 介面尋找相關備份設定。

常見問題解答 (FAQ)

Q: 存取本機網域時出現「網站無法訪問」或 404 錯誤怎麼辦？A: 請檢查如下：
1. 確認 ServBay 正在執行中。
2. 於 ServBay「網站」列表確認 Joomla 網站已經啟用。
3. 檢查網站設定中的「網站根目錄」是否正確指向 /Applications/ServBay/www/servbay-joomla-app。
4. 確認您輸入的網域（servbay-joomla.local）與 ServBay 設定一致。
Q: Joomla 安裝時出現資料庫連線錯誤要怎麼處理？A: 通常是因資料庫連線資訊設定不正確造成，請檢核：
1. 安裝程式輸入的資料庫主機名稱是否為 localhost。
2. 資料庫用戶名稱（如 servbay_joomla_user）及密碼（如 password123）與您在 phpMyAdmin 建立的是否完全相符。
3. 資料庫名稱（如 servbay_joomla_user）是否正確。
4. 確保 ServBay 的資料庫服務（如 MySQL/MariaDB）有啟動。
Q: 忘記 ServBay 的 MySQL root 密碼怎麼辦？A: ServBay 提供重設資料庫 root 密碼的功能。請至 ServBay 介面找到相關管理選項即可安全重設 MySQL 或 MariaDB root 帳號密碼。
Q: 安裝完成後網站出現錯誤或畫面空白怎麼辦？A: 請確認您已經刪除 installation 資料夾。可檢查 Joomla 錯誤日誌（如已設定）或 PHP 錯誤日誌（可於 ServBay 設定或檢視 PHP 的 error_reporting 及 display_errors），以取得詳細錯誤資訊。亦請確認目前 PHP 版本符合 Joomla 要求。

小結

透過 ServBay，在 macOS 上安裝與設定 Joomla CMS 十分直接且高效。ServBay 提供預先配置的本機開發環境，整合了網頁伺服器、資料庫與 PHP，極大化簡化 Joomla 的安裝與管理。遵循本指南操作後，您即可快速架設本機 Joomla 開發環境，展開網站架構與開發之旅。請記得保持 ServBay 與 Joomla 均為最新版本，並遵循安全性最佳實踐。

在 macOS 的 ServBay 環境中安裝與設定 Joomla CMS ​

概述 ​

什麼是 Joomla？ ​

應用情境 ​

先決條件 ​

Joomla 安裝步驟 ​

步驟 1：下載 Joomla ​

步驟 2：解壓 Joomla ​

步驟 3：建立資料庫及用戶 ​

步驟 4：設定網頁伺服器（新增網站） ​

步驟 5：執行 Joomla 安裝流程 ​

步驟 6：探索 Joomla 管理後台 ​

用 Joomla 建站入門（簡介） ​

注意事項 ​

常見問題解答 (FAQ) ​

小結 ​