在 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
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
注意: 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
1
2
3
4
5
2
3
4
5
解壓完成後,servbay-joomla-app
資料夾下將會包含 Joomla 所有安裝檔案。
步驟 3:建立資料庫及用戶
Joomla 需使用資料庫來儲存內容、組態與用戶資料。我們將透過 ServBay 內建的 phpMyAdmin 工具來建立資料庫及對應的使用者。
開啟 ServBay 控制面板
於瀏覽器輸入 ServBay 的本機控制面板網址:
https://servbay.host/
。這是 ServBay 提供的便捷入口,可直接存取 phpMyAdmin、phpinfo 等工具。進入 phpMyAdmin
在 ServBay 控制面板畫面,點選「phpMyAdmin」連結以進入資料庫管理界面。
新增資料庫使用者
為提升安全性,建議每個應用獨立建立一組資料庫用戶。
導航至用戶帳號管理
於 phpMyAdmin 上方功能列點選「用戶帳號」。
新增用戶帳號
點擊「新增用戶帳號」,並填寫以下資訊:
- 使用者名稱: 輸入您想建立的資料庫用戶名稱,例如
servbay_joomla_user
。 - 主機名稱: 選擇
localhost
,代表此用戶只能自本機連線,提升安全。 - 密碼: 請設定強密碼,並妥善保存。例如此處以
password123
作為示範(實際使用時請務必換成複雜密碼)。 - 重複輸入密碼: 再輸入一次欲設定的密碼以確認。
- 為使用者建立資料庫: 勾選「建立與使用者名稱相同的資料庫並賦予所有權限」,系統將自動以用戶名建立資料庫(如
servbay_joomla_user
),並賦予該用戶完全管理權限。 - 全域權限: 切勿勾選「賦予全域所有權限」。我們僅希望此用戶只管理他自己的資料庫。
- 使用者名稱: 輸入您想建立的資料庫用戶名稱,例如
確認建立
檢查所有設定後,點選頁面底部的「執行」按鈕完成用戶及資料庫的建立。
步驟 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
。
- 名稱 (Name): 輸入此網站的識別名稱,例如
儲存設定
所有資訊確認填寫正確後,點選底部的「儲存」按鈕。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): 若是全新安裝,選「備份」或「刪除」皆可,若資料庫是空的則差異不大。
- 資料庫類型 (Database Type): 通常選
- 總結 (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: 請檢查如下:
- 確認 ServBay 正在執行中。
- 於 ServBay「網站」列表確認 Joomla 網站已經啟用。
- 檢查網站設定中的「網站根目錄」是否正確指向
/Applications/ServBay/www/servbay-joomla-app
。 - 確認您輸入的網域(
servbay-joomla.local
)與 ServBay 設定一致。
Q: Joomla 安裝時出現資料庫連線錯誤要怎麼處理?A: 通常是因資料庫連線資訊設定不正確造成,請檢核:
- 安裝程式輸入的資料庫主機名稱是否為
localhost
。 - 資料庫用戶名稱(如
servbay_joomla_user
)及密碼(如password123
)與您在 phpMyAdmin 建立的是否完全相符。 - 資料庫名稱(如
servbay_joomla_user
)是否正確。 - 確保 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 均為最新版本,並遵循安全性最佳實踐。