想像一下，你的精心設計的 silverstripe 網站突然遭遇了一個意外情況，比如一個頁面找不到了（404），或者服務器內部發生了錯誤（500）。這時，用戶會看到什么？通常是一個由服務器或框架提供的、毫無特色的通用錯誤頁面。這不僅讓用戶感到困惑和沮喪，也與你的網站整體設計格格不入，甚至可能因為緩存問題顯示過時的信息。這種體驗，無疑會大大損害用戶對你網站的信任感和專業度。
作為開發者或網站管理員，我們當然希望即使在出現錯誤時，也能保持用戶體驗的連貫性和品牌的專業性。我們需要一個解決方案，能夠讓我們自定義這些錯誤頁面，并使其內容易于管理和更新。幸運的是，silverStripe 生態系統為我們提供了 silverstripe/Errorpage 這個強大的 composer 包，它正是解決這個問題的利器。
Composer在線學習地址：學習地址
告別通用錯誤：引入 silverstripe/errorpage
silverstripe/errorpage 是 SilverStripe cms 的一個核心組件，它允許 CMS 作者為不同的錯誤代碼（如 404 Not Found, 500 internal Server Error 等）設置自定義內容。這意味著你可以直接在 CMS 后臺創建和編輯這些錯誤頁面，讓它們擁有和網站其他部分一致的樣式和內容，從而提供更友好的用戶引導。
安裝，輕而易舉：
使用 Composer 安裝這個包非常簡單：
composer require silverstripe/errorpage
運行這條命令后，Composer 會自動下載并安裝 silverstripe/errorpage 及其所有依賴。完成安裝后，你需要運行 dev/build?flush=all 來更新你的 SilverStripe 數據庫和配置。
如何使用 silverstripe/errorpage 解決問題
安裝完成后，你會在 SilverStripe CMS 的“頁面”區域發現一個新的頁面類型——“ErrorPage”。現在，你可以開始創建你的自定義錯誤頁面了。
-
創建自定義錯誤頁面： 在 CMS 后臺，點擊“添加新頁面”，然后選擇“ErrorPage”類型。你可以為這個頁面指定一個標題，并在內容區域輸入你希望用戶看到的錯誤信息。最關鍵的是，你可以在頁面的設置中選擇這個錯誤頁面對應的 http 狀態碼（例如 404、500、403 等）。
-
主題化你的錯誤頁面：silverstripe/errorpage 允許你的錯誤頁面完全遵循網站的主題。你只需要在你的主題目錄中創建 templates/SilverStripe/ErrorPage/ErrorPage.ss 或 templates/SilverStripe/ErrorPage/Layout/ErrorPage.ss 文件，就可以自定義錯誤頁面的布局和樣式。這樣，即使在錯誤發生時，用戶也能感受到你的品牌一致性。
-
顯示詳細的錯誤信息（可選，謹慎使用）： 對于開發者而言，有時在錯誤頁面上顯示更詳細的錯誤信息會很有幫助。如果你在代碼中使用了 $this->httpError($code, $message) 方法，并希望將 $message 顯示在錯誤頁面上，你可以在 ErrorPage.ss 模板中加入 $ResponseErrorMessage 變量。
<h1>$Title</h1> <% if ResponseErrorMessage %> <p class="lead"> $ResponseErrorMessage </p> <% end_if %>
注意： 默認情況下，這個變量只在開發模式（dev mode）下顯示。出于安全考慮，強烈建議不要在生產環境中公開這些詳細信息，除非你確切知道自己在做什么。你也可以通過配置禁用它：
SilverStripeErrorPageErrorPage: dev_append_error_message: false
-
限制 CMS 中的錯誤代碼選項： 默認情況下，CMS 后臺的錯誤頁面類型會顯示所有可用的 HTTP 錯誤代碼。這可能會讓內容編輯者感到困惑。你可以通過配置來限制下拉列表中顯示的錯誤代碼，只顯示你網站常用的那些，例如：
SilverStripeErrorPageErrorPage: allowed_error_codes: - 400 - 403 - 404 - 500
總結：silverstripe/errorpage 的優勢與實際效果
使用 silverstripe/errorpage 帶來的好處是顯而易見的：
- 提升用戶體驗： 用戶不再面對冰冷的通用錯誤，而是友好的、有指導意義的頁面，減少了挫敗感。
- 保持品牌一致性： 錯誤頁面也能融入你的網站設計，強化品牌形象。
- CMS 驅動，易于管理： 內容編輯者可以直接在后臺更新錯誤頁面內容，無需開發者介入。
- 更好的問題排查（有限）： 在開發模式下顯示詳細錯誤信息有助于調試。
盡管 silverstripe/errorpage 在處理靜態錯誤頁面生成方面存在一些歷史遺留的局限性（例如，靜態頁面可能不會被頻繁重新生成，導致在 500 錯誤時顯示舊內容），但它提供的 CMS 集成和自定義能力，已經大大改善了 SilverStripe 網站的錯誤處理體驗。
下次當你的 SilverStripe 網站遇到“意外”時，請確保你的錯誤頁面不再是用戶體驗的終點，而是品牌溫度和專業度的體現。給 silverstripe/errorpage 一個機會，它會讓你網站的“故障”時刻也變得優雅起來。
