網站升級：一步步從 Joomla 3.x 到 4.x 的網站升級教學

Joomla教學文件

26 十一月 2024

點擊數: 2221

2024.11.26 更新 - 升級到 joomla5 的步驟
請參考以下網址：
https://des13.com/faq/cms/joomla/1606-joomla5.html

從 Joomla 3.x 到 Joomla 5.x 的網站升級教學，網站升級之後會大大提升網站在google中的露出率！

透過 Joomla 網站升級教學，我們將一步步帶你從 Joomla 3.10. x 版本無縫升級到更強大的 Joomla 4.x。

快點進行網站升級，讓網站焕然一新，排名暴漲！引爆網站潛力！

網站為什麼要升級?

讓我們一起揭開網站升級的神秘面紗！網站升級不僅僅是個小動作，它代表著無限的可能性。為什麼網站應該緊隨潮流，勇往直前進行升級呢?

1. 提升網站競爭力：

在競爭激烈的網路世界，使用過時的網站技術遠遠不夠。透過網站升級，更新網站的技術和功能，使網站更具吸引力，從而贏得用戶的關注，脫穎而出於競爭對手之上。

2. 優化使用者體驗：

現代用戶注重體驗，他們喜歡快速、流暢的網站。網站升級可以讓網站更快、更靈活，提供更好的使用者體驗，增加用戶黏性和滿意度。

3. 加強安全性：

網站安全是至關重要的，特別是面對日益複雜的網路威脅。網站升級可以讓網站獲得更強大的安全性保護，減少遭受攻擊的風險，確保用戶資料的安全。

4. 體驗新功能：

新版本網站帶來的新功能可以改善網站的互動性、內容展示和用戶參與，讓網站更加生動有趣，吸引更多用戶互動。

5. 提升SEO排名：

搜尋引擎更傾向於推薦更新、優化的網站。透過網站升級，改進網站的結構、速度和內容，提高在搜尋引擎中的排名和曝光率，吸引更多有價值的流量。

網站升級不僅僅是技術性的變化，更是對網站和品牌的投資。透過不斷地更新和提升，讓網站可以保持在網路世界中的競爭力，為用戶提供更好的體驗，實現網站的最大潛力！趕快踏上網站升級之旅，讓網站綻放新的光彩！

這是一篇超實用的從 Joomla 3.10.x 到 Joomla 4.x 的網站升級教學，一步步將網站升級到最強 Joomla 4.0 版本！如果你還在用老舊的 Joomla 版本，請先跟著我們一步步升級到 Joomla 3.10 喔，然後再平穩轉換到 Joomla 4。誰說升級是難事？讓我們為你揭開升級的神秘面紗！

Joomla3 和 Joomla4 的比較表

Joomla 4 擁有而 Joomla 3 沒有的功能和改進：

1. 全新後台管理介面

設計：Joomla 4 引入了一個全新的後台管理介面，提供更現代化和直覺的用戶體驗。
可及性：後台管理介面遵循 WCAG 2.1 AA 無障礙標準，確保對所有用戶的可及性。
註：這是 Web Content Accessibility Guidelines (WCAG) 的官方網站，WCAG 是由 W3C（World Wide Web Consortium，世界資訊網協會）制定的一系列準則，用於評估和改進網站的可及性。WCAG 旨在確保網站內容對於所有用戶，包括殘障人士，也是完全可訪問和可理解的。WCAG 2.1 是 WCAG 的最新版本，它提供了一系列的準則、成功標準和技術建議，以幫助網站開發者創建無障礙的網站內容。

2. 性能優化

更快的加載速度：通過多種性能優化技術，Joomla 4 的加載速度顯著提升。
改善的緩存機制：優化的緩存系統，提供更高效的網站運行速度。

3. Web Services API

完整的API支援：Joomla 4 引入了完整的 Web Services API 支援，使得網站資料可以與其他應用程式更容易地集成。

4. 工作流程

工作流程管理：Joomla 4 提供了改進的工作流程和發布管理功能，讓內容管理和發布過程更加順暢。

5. 多語言支援

改進的多語言功能：Joomla 4 提供更強大的多語言支援，讓網站更容易進行多語言管理和翻譯。

6. 前端框架

Bootstrap 4：Joomla 4 基於 Bootstrap 4，提供更現代的前端框架和響應式設計。

7. SEO 功能

改進的 SEO 工具：Joomla 4 提供了更先進的 SEO 工具，幫助網站在 google 中的排名更高。

8. 開發者工具

友好的開發者框架：Joomla 4 為開發者提供了更友好的工具和框架，支持更現代的開發技術和流程。

9. 安全性

強化的安全功能：Joomla 4 增強了安全功能，提供更高級的安全保護措施，保障網站安全。

10. 版本控制

內容版本控制：Joomla 4 引入了內容版本控制功能，讓用戶可以更輕鬆地管理和恢復內容版本。

11. 佈景主題系統

改進的佈景主題系統：Joomla 4 提供了一個更靈活的佈景主題系統，支援 PHP 代碼佈景主題和更先進的佈景主題技術。

12. 安裝和更新

一鍵更新：改進的一鍵更新功能，讓用戶可以更輕鬆地更新網站到最新版本。

13. 會員管理

增強的用戶管理：提供了更細緻的會員管理和權限控制功能。

14. 改進的媒體管理

新媒體管理器：提供了更直覺和強大的媒體管理工具，支持大量上傳和文件管理。

這些新功能和改進使得 Joomla 4 在性能、易用性、安全性和靈活性方面有了顯著的提升，為用戶提供了更強大的工具和更好的網站管理體驗。

Joomla 功能和改進表：

功能/改進	Joomla 3	Joomla 4
後台管理介面	傳統設計，相對較簡單	全新設計，提供更直覺和現代化的使用者介面
性能優化	相對較慢的載入速度，簡單的緩存系統	更快的載入速度，優化的緩存系統
Web Services API支持	有限的支持	完整的支持
工作流程管理	傳統的工作流程和發佈管理	改進的工作流程和發佈管理
多語言支援	有限的多語言支援	改進的多語言支援
前端框架	自訂或其他框架	基於 Bootstrap 4
SEO 功能	基本的 SEO 工具	改進的 SEO 工具
開發者工具	有限的開發者工具和框架	更友好的開發者工具和框架
安全性	基本的安全功能	強化的安全功能
版本控制	無版本控制功能	內容版本控制功能
佈景主題系統	傳統的範佈景主題系統	改進的佈景主題系統
安裝和更新	一鍵更新功能	一鍵更新功能
會員管理	會員的用戶管理	增強的會員管理
媒體管理	傳統的媒體管理器	新的媒體管理器

Joomla3和Joomla4的差異比較表

項目	舊Joomla 3	新Joomla 4
使用者介面設計	介面傳統，功能多樣但介面稍顯複雜	現代化設計，操作直覺，後台介面清新，使用體驗優化
性能與速度	性能和加載速度普通，需要額外優化	性能顯著提升，頁面加載速度更快，支援最新技術
安全性	已達一定水準，但仍需定期更新補丁，面臨較高風險	安全性大幅提升，內建更多安全功能，支持最新安全標準
SEO 友好性	具備基本SEO功能，但需額外外掛	內建強大SEO工具，無需外掛即可優化，提供更細緻設定
擴展性與開發者支持	外掛和元件佈景，但部分已不再更新，社群活躍度低	擴展性更強，支持現代化外掛和主題佈景，開發者社群活躍
可用性與易用性	使用門檻高，對初學者不友好，需要較多學習時間	注重用戶體驗，簡單易上手，提供詳細操作及說明文件

Joomla 3.x 到 Joomla 4.x 的網站升級說明

從 Joomla 的核心擴充功能開始。

Joomla 的強大之處就在於，許多核心和外掛都能在後台進行快速升級！不過也有例外，我們需要仔細檢查每個外掛的升級路徑，確認從 joomla 3.10 升級到 joomla 4.x 是順利的。記得「Self Assessment and Planning for 3.10 to 4.x Migration」這篇文章嗎？如果還沒看過，別擔心，趕快翻閱一下，絕對會提供不少幫助！

Joomla 的核心擴充功能：

Categories 分類
Articles 文章，這個應該都不陌生吧，就是網站的內容。
Menus 選單，讓網站有個好看的導覽。
Modules (core modules - not third-party) 模組（核心模組，不是外掛），這些是固定的小工具，可以放在網站不同的地方。
Action Logs 行動紀錄，這個是紀錄網站裡的操作。
Banners
Fields 欄位，這是可以自訂網站的資料欄位。
Content History 歷史內容
Contacts 聯絡方式，讓大家找到你的方式。
Messaging 訊息，和大家互動的方式之一。
Newsfeeds 新聞訂閱
Redirect 轉址，讓網址轉向到對的地方。
Search (decoupled in 4.x. Existing 3.x sites will still migrate it. However we recommend using Smart Search going forward. See Notes under Assess Each Extension)
搜尋（在 4.x 版本中拆分了，不過現有的 3.x 網站還是會保留。我們建議以後用「智能搜尋」。）
Smart Search 智能搜尋，讓搜尋更聰明一點！
Tags 標籤，給內容貼上標籤。
Weblinks (decoupled but your site may be using it and it will migrate. See Notes under Assess Each Extension.)
網站連結（不用擔心，會幫你搬家的）

就是這些啦，開始你的 Joomla 網站升級之旅吧！記得要在動手之前，看看之前的那篇「自我評估和計畫從 3.10 升到 4.x」哦！

Step by Step Joomla 網站升級一步一步

1. 確認網站是 Joomla 3.10.x 最新版本

2. 備份現有的 Joomla 3.10.x 網站

3. 確保主機環境符合 Joomla 4 的技術需求，這是成功升級的關鍵。

4. 建立一個嶄新的資料庫和使用者，好讓我們能將現有 Joomla 3.10.x 版本的內容順利還原進去。

5. 在一個測試用的網站或工作區裡，將備份好的 Joomla 3.10.x 內容放進去。這裡有幾個選擇：

子網域
子目錄
如果你想在本地進行網站升級，有一篇「在本地安裝 Joomla」的詳細教程。當然，WAMP、MAMP、LAMP 這些工具也都是絕佳的選擇。
如果在遷移的過程中換主機，新的主機帳號也是不錯的選擇。

6. 在「測試站」中，可以選擇將備份的內容還原到以下地方，開始進行升級的第一步：

本地設備：如果選擇在電腦上進行，別錯過這篇教學「在本地安裝 Joomla」和「設定 Joomla 開發環境」。

7. 請確認要升級的網站是 Joomla 3.10.x 最新版本，而且資料庫結構也是最新的。

到網站後台→「擴充套件」→「資料庫」，如果網站結構沒有跟下面的圖片一樣，點一下「修復」按鈕。

8. 清一下垃圾桶：

垃圾桶裡有沒有什麼文章？如果有的話，請把它們刪掉（如果在其他地方沒用到，那麼也刪掉相關的媒體檔案）。

垃圾桶裡的文章（連同分類和選單項目）可能會在網站升級的時候出問題哦。

9. 測試一下。

10. 再次備份一次。

接下來會繼續進行網站升級，看看怎麼從 Joomla 3.10.x 變成 Joomla 4.x 版本的喔！加油！

檢視每個 Joomla 外掛

在網站升級計畫中，我們必須明確規劃哪些外掛需要保留，哪些需要移除，以及如何進行更新和升級。

1. 請至網站後台→「元件」→「Joomla! 更新」的「檢查更新」和「擴充套件」→「管理」→「管理」。

2. 檢視每個已安裝在網站上的外掛，然後根據需求決定是否更新至最新版本或將其移除。更詳細的資訊可以參考「Pre-Update Check」。

如何使用「Pre-Update Check」功能呢？為了使用這個功能，需要將「Joomla 更新」元件設定為 Joomla 4 版本。來看看怎麼做：

到「元件」→「Joomla 更新」。（它應該會顯示沒有可用的更新。如果不是這樣，就把 Joomla 更新到最新版本（必須是 3.10.x），然後再測試一下。之後再做一次備份。）
點擊右上角的「選項」按鈕。
在更新頻道的下拉選單中，選擇「Joomla Next」。
點擊「儲存並關閉」。
頁面會顯示已經安裝的 Joomla 版本、最新的 Joomla! 版本，以及進行更新元件的連結。Joomla 會再次列出 Joomla 4 的系統需求，如果 Joomla 發現有任何系統或外掛不相容的情況，會在這裡提示。別忘了花一些時間仔細檢查這個頁面的內容。

重要注意事項!!
請還不要將網站升級到 Joomla! 4。這只是為了讓現有網站的外掛，能夠與 Joomla! 4 相容。所以千萬不要現在就升級喔！

3. 「Pre-Update Check」：如果有任何無法直接進行升級的外掛，它們會在這裡列出。請將它們新增至需進行特別網站升級的外掛清單中。

4. 如果網站是從 Joomla! 2.5 升級到 Joomla 3.x，可能會有一些遺留的外掛需要移除乾淨。以下是一些在升級到 Joomla 4 之前需要先刪除的舊版 Joomla 2.5 或 Joomla 3.x 外掛：

plg_content_geshi
PKG_JOOMLA
Bluestork 後台模板
Beez_20
Beez5
Atomic

5. 至於模板部分，除了 Protostar 和 Beez3（前端和後台的預設模板）以外，其他核心模板都需刪除。要特別注意的是，Protostar 與 Joomla 4 不相容，在升級過程中會消失。所以請先選擇 Beez3 作為「預設」模板。

6. 如果遇到其他需要刪除的檔案，請把它們加到這個頁面上！

7. 這裡的標籤會告訴我們外掛是否相容。如果標籤顯示為「Missing Compatibility Tag」，這表示外掛開發者在其外掛中未使用標籤，因此無法確定其是否與 Joomla 4 相容。可以主動與開發者溝通，確認一下相容性情況。

8. 更新外掛：

將保留在網站上的外掛進行更新：在 Joomla! 3.10.x 版本中，前往「擴充套件」→「更新」，點擊「尋找更新」，這將在「管理」的「版本」欄位下加入一個小工具提示，提供一些從後台獲取的相容性資訊。

這個功能只支援透過「擴充套件」進行更新的外掛。若網站安裝了不使用 Joomla 外掛更新的外掛，則需要進行手動評估。同樣地，對於具有工具提示的外掛，也需要與外掛開發者核對，確定如何進行升級，並檢查套件的類型和升級路徑。

9. 調查和刪除外掛：

前往「擴充套件」→「管理」。點擊「搜尋工具」按鈕，以顯示過濾選項。從「選擇類型」下拉選單中選擇「套件包」。

建議選擇「套件包」，因為這樣如果需要刪除某個套件，它會自動將相關的模組、外掛或套件內的其他東西一併刪除。

10. 將不再需要或無法遷移到 Joomla 4 的套件解除安裝。接下來，請按照以下步驟進行：

(1) 管理所有下拉選單中的類型：包括元件、檔案、語言、程式庫、模組、外掛和模板。

(2) 若套件的作者是 Joomla! Project，則無需對這些外掛進行操作。

(3) 將不再使用或無法與 Joomla 4.x 相容的外掛解除安裝。

注意！
如果某個模板已被設定為預設，則無法將其解除安裝。請挑選一個核心支援的模板，例如 Beez3 或 Protostar，並在需要時進行解除安裝。同時，也要特別注意：Protostar 與 Joomla 4.x 不相容，在遷移的過程中它將被移除。將其設定為預設模板只是為了進行 Joomla 4.x 的升級。

11. 記錄目前正在運行並計畫保留在網站上的套件和元件版本，將它們複製或貼上到文件中以供日後參考。

12. 請確認所有外掛都升級到最新版本，在進行更新之前和更新過程中，要特別注意這些外掛是否在同一套件中具有 3.10.x 和 4.x 版本。如果是，那麼它們可以安心進行「一鍵更新」。但如果不是，且 3.10.x 和 4.x 有不同的套件，這些情況將可能發生：

外掛具有獨立的套件，在升級到 4.x 版本後會自動偵測並繼續運作。請與開發者確認這一點。
外掛具有獨立的套件，在升級到 4.x 版本前需要在 3.10.x 版本中進行解除安裝，然後在網站成功遷移到 4.x 版本後再安裝 Joomla 4.x 版本。

想了解更多有關模板的特定資訊，請參閱「模板考量」，以及有關「轉換先前 Joomla! 版本的模板」的說明。

搜尋（com_search）的注意事項

在 Joomla 4.x 版本中，搜尋功能（com_search）將被進行拆分。升級至 Joomla 4.x 版本後，需要透過 com_installer 進行搜尋功能的更新。雖然 Joomla 仍然會持續進行維護，但更新方式將與第三方外掛相同，透過 com_installer 進行更新。我們建議使用智能搜尋（com_finder）功能，以獲得更佳的搜尋體驗。

有關網頁連結 Weblinks

在 Joomla 3.4 版本時，網頁連結功能已經進行了拆分。如果網站是從 Joomla 2.5 版本升級而來，升級過程將會自動辨識並且升級網頁連結元件及相關資料。從 Joomla 3.10.x 到 Joomla 4.x 的升級也是類似的情況。網頁連結元件依然會在官方外掛目錄（JED）中提供，並且持續進行維護。

有關舊版路由 Legacy Routing

在 Joomla 4.x 版本中，將不再提供對舊版路由的支援，只會保留現代版路由供使用。網站升級過程中，如果網站使用了舊版路由，系統會自動轉換為現代版路由。在升級到 Joomla 4.x 之後，但在正式上線前，我們建議您運行損壞連結檢查工具，確保網站連結的正常運作。

前往 Joomla! 4.x

已經更新或解除安裝了僅與 Joomla! 4 相容的第三方外掛，不相容的外掛都已刪除後，可以繼續進行以下步驟：

1. 前往「系統」→「全域設定」→「伺服器」，將「錯誤回報」從「系統預設」調整為「最大」。別忘了點擊「儲存並關閉」。

2. 再次進行一次備份。

3. 前往「元件」→「Joomla 更新」。（它應該會顯示沒有可用的更新。如果不是這樣，就把 Joomla 更新到最新版本並測試一下，之後再做一次備份。

4. 點擊右上角的「選項」按鈕。從更新頻道的下拉選單中選擇「Joomla Next」。

5. 點擊「儲存並關閉」。接著會看到已安裝的 Joomla 版本、最新的 Joomla! 版本，還有更新套件的網址。

6. Joomla 會再次顯示 Joomla 4 的系統需求。如果它檢查出系統或外掛有不相容，會在這裡告訴你。請花一點時間仔細審查這個頁面。

7. 如果更新沒有出現，前往「擴充套件」→「更新」，並從工具列中選擇「清除快取」，現在 Joomla! 4 的更新應該會顯示出來。

8. 確認有備份可用，以防萬一。

9. 點擊「安裝更新」按鈕。

10. 在狀態欄完全變綠之際，泡杯茶吧。

這個過程的時間取決的網站、網路連線和伺服器速度，可能會花幾分鐘的時間，總共有超過 12,000 個檔案，佔用 75 兆字節的容量需要被解壓縮。

當更新完成時，可能會被登出管理員。如果一切順利，會看到後台面板全新的外觀。

11. 前往「系統」→「維護」→「資料庫」，如果有任何錯誤顯示，點擊「修復」。

12. 在「系統」→「安裝」→「發現」中，看看是否有任何需要安裝的外掛。（理應是沒有的！）

13. 前往網站前端，確認是否有內容顯示，即使這可能不是正確的模板。如果有內容出現，那麼可以繼續進行下一步。然而，如果發現前端無法正確顯示內容，請參閱常見的升級錯誤處理方法。

14. 進行一次備份。

15. 若有新的模板或其他外掛需要安裝，現在進行安裝吧！記得要定期備份。

16. 執行損壞連結檢查，修復任何損壞的連結。測試所有功能，同時保持定期備份。

17. 若一切正常運作，將「錯誤回報」設定恢復為「系統預設」（進入「系統」→「全域設定」→「伺服器」分頁）。不要忘記點擊「儲存並關閉」。此外，請務必仔細閱讀安裝後的重要訊息。

進行 Joomla! 4.x 網站的上線操作

當準備好進行網站上線前的最終步驟時，記得先對 joomla 3.10 版本網站進行最後一次備份。如果有需要，可以將它回復到一個子目錄或子域名。

接著，備份全新 Joomla! 4.x 網站，然後將它遷移到根目錄，或者如果在新的虛擬主機帳戶下使用了臨時域名，別忘了更新名稱伺服器設定。在進行這一切之前，不妨再次進行測試，確保一切順利。

倘若在升級至 Joomla! 4.x 過程中曾對 .htaccess 檔案進行安全性調整，有可能需要調整其中的一行或多行，以適應 Joomla 4 的更新。

要確定是否需要修改你的檔案，請前往「Htaccess changes after joomla4.0.4」進行查看。

在幾天內，除非已經修改了 robots.txt 檔案以封鎖搜尋引擎蜘蛛並停用了網站前端，否則可將 Joomla! 3.10 版本的 Joomla! 網站從伺服器上刪除。

記得移除曾經使用過的所有開發網站，或者如果它們仍運行在最新版本，則繼續保持更新，以保護伺服器不受駭客攻擊。

若在 Joomla! 4.x 網站升級過程中， Joomla! 3.10 版本網站進行了資料更改，上線前務必將這些資料順利轉移到 Joomla! 4.x 網站上。可以手動進行（需確保保持相同的使用者 ID - 按順序進行），或者選擇使用第三方外掛來協助。

Joomla!4.x 升級到 Joomla!5

好消息～Joomla 從 4.4.x 升級到 5.x 只是「升級」，不是「大搬家」喔！原因有兩個：

只要 Joomla 4 的擴充套件已經把舊的程式碼移除、使用最新版的 Joomla 代碼，就可以在 Joomla 5 繼續跑～
其他大部分的擴充套件，只要打開「回溯相容插件」，也能夠正常運作！

簡單來說，就是升級超方便，大家不用太擔心！

1. Joomla!4.4.x 升級到 Joomla!5.x 教學簡化版

這份文件將規劃和步驟合併成單一文件，讓流程更簡單！

但還是需要一定的技術知識哦。

建議先檢查「自我評估表」來判斷是否要自行進行升級。

必備連結：第三方擴充套件開發者注意

2. 升級計畫 (Joomla!4.4.x -> Joomla!5.x)

(1) 主機／技術需求

確認主機是否符合升級需求
要升級到 Joomla 5，伺服器環境必須符合基本技術規範。如果不符合需求，在 Joomla 更新元件中不會顯示升級選項。
技術要求
- PHP：8.1 版
- MySQL：8.0.13 版以上
- MariaDB：10.4.x（測試顯示 Joomla 3、4 和 5 均相容 MariaDB 10.4.x）
- PostgreSQL：12.0 版以上
檢查系統資訊
在 Joomla 4 網站中，點擊「系統」->「系統資訊」以檢查當前伺服器配置是否符合升級需求。如果不符合，請聯絡主機提供商。

參考文章

Joomla 3.x to 4.x Step by Step Migration

推薦閱讀：全後台模組化形象官網

簡易電子書下載：一頁式網頁設計電子書

如果您喜歡我們的文章，歡迎分享！也歡迎查看我們的其他文章。如果有任何疑問也歡迎加line和我們聯絡

全後台模組化形象官網，符合各式商業模式與需求，請參考：https://des13.com/service/rwd.html

Written by Ring
作者：益盛科技專案經理
通過Google Ads-Measurement Assessment
15年網站專案管理及人員管理實務經驗。
具網站美編企劃繪製能力
具多媒體網頁設計與 RWD設計之實務經驗

Joomla教學文件