如何使用 WordPress 調試模式修復站點錯誤

已發表: 2021-11-11

儘管 WordPress 作為一個平台非常穩定，但您有時會遇到錯誤。 更重要的是，您可能不知道它是如何到達那裡的，或者您可以做些什麼來修復它。 在這種情況下，WordPress 調試模式是救命稻草。

調試是找出“錯誤”為何造成破壞的一種方法，儘管您還必須弄清楚如何修復它。 一些調試消息會給你一個指針。 不過，一旦調試模式為您提供幫助，修復過程通常很簡單。

在這篇文章中，我們將向您展示您需要了解的有關 WordPress 調試模式的所有信息。 首先，讓我們更深入地了解該模式的作用。

什麼是 WordPress 調試模式

在很多情況下，您已經看到了一個正在運行的調試版本。 當您在 WordPress 網站上遇到錯誤時，這只是調試過程的一小部分——終點。 在正常情況下，您會在您的網站上看到重大嚴重錯誤的通知。 想想諸如建立數據庫連接錯誤或 500 內部服務器錯誤之類的問題。

錯誤建立數據庫連接錯誤。

不過，還有更多“無聲”的錯誤。 換句話說，除非您找出錯誤，否則您不會知道發生了錯誤。 WordPress 調試模式非常適合這些情況。

它將在您網站的後端或前端顯示通知，並且不排除錯誤。 啟用調試模式（也稱為WP_DEBUG ）也將顯示有關您的底層代碼的警告和通知。 例如，您經常會看到您網站的某些方面的錯誤，而這些錯誤並未出現或表現不佳。 這是設計使然。

因此，您可以使用WP_DEBUG來捕捉您網站的 PHP 代碼的問題，這些問題在修復後將為您提供更具抵抗力和性能的基礎。

為什麼要使用 WordPress 調試模式

可以公平地說，從表面上看，使用WP_DEBUG對普通站點用戶來說並沒有太多好處。 這可能是這種情況，儘管它不是普遍的。 事實上，對於大多數網站，您不需要使用調試模式，因為 WordPress 擅長處理和顯示錯誤。

不過，我們可以想到一些使用 WordPress 調試模式很方便的情況：

  • 即使對於典型的網站所有者，激活WP_DEBUG也可以幫助您診斷在正常情況下不會出現的複雜問題。 一個例子是 WordPress 白屏死機 (WSoD)。 很多時候，如果您使用 WordPress 調試模式，您會發現一個錯誤，這將使您在尋找修復程序方面處於領先地位。
  • 如果您是開發人員， WP_DEBUG將是您工作流程中的寶貴工具。 這是因為您想了解站點破壞錯誤，以及那些可能導致問題的瑣碎問題。 WordPress 調試模式顯示了所有這些以及更多內容。 例如，您還將在代碼中看到有關折舊函數和參數的通知。 這些現在不會破壞您的網站，但是一旦這些功能在以後消失時就會成為問題。

通常， WP_DEBUG不應在實時站點上處於活動狀態。 因此，在使用本地或臨時環境時，它更像是一種開發工具。 即便如此，調試模式確實可以用於實時站點，但頻率很小且有規律。

如果您在實時站點上使用調試模式，則需要遵循一些規則：不要長時間使用它，在您的站點流量最少的時候激活它，並在完成後停用WP_DEBUG 。 這將最大程度地降低所涉及的風險，並使您的站點維護遠離最終用戶的視線。

如何以 2 種方式為您的網站啟用 WordPress 調試模式

如果您想啟用 WordPress 調試模式，有兩種典型的方法：

  • 打開您的wp-config.php文件並添加幾行代碼。
  • 安裝並激活插件以啟用調試模式。

還有一些相關和配套模式也可以幫助您調試您的網站。 我們將在後面的部分中介紹這些，但現在，讓我們介紹手動方法。

1.通過wp-config.php文件開啟調試模式

如果你熟悉 WordPress 的核心文件，你就會知道wp-config.php 。 對於初學者，此文件存儲您的站點和服務器配置設置。 這是一個可能導致建立數據庫連接時出錯的文件，以及其他問題。

因此，這是一個您應該謹慎對待的文件。 因此，您要確保在開始之前準備好以下內容：

  • 了解安全文件傳輸協議 (SFTP) 以及使用它的技能。
  • 合適的 SFTP 客戶端，例如 FileZilla、Cyber​​duck 或 Transmit。
  • 您的 SFTP 憑證，您可以在託管儀表板或來自您的提供商的電子郵件中找到。
  • 網站的干淨和最新備份，以防您必須回滾更改。
  • 您可能需要一個專用的文本編輯器，但這不是必需的。

一旦你有了這些，通過 SFTP 登錄到你的站點。 如果您只運行一個站點，則可以使用根目錄（也稱為www或public_html ）。

通過 SFTP 訪問 WordPress 根目錄。

但是，如果您在服務器上運行多個站點，它也可能位於具有您站點名稱的目錄中。 一旦你在正確的地方，尋找wp-config.php文件。 請注意，還有一個wp-config-sample.php文件，但這不是您所需要的。

找到文件後，右鍵單擊並選擇要編輯的選項。 這將根據您的 SFTP 解決方案而有所不同，但通常很難錯過：

使用 SFTP 打開文件。

打開文件後，您需要添加一行來啟用調試模式：

define( 'WP_DEBUG', true);

在讀取/* That's all, stop editing! Happy blogging. */ /* That's all, stop editing! Happy blogging. */ /* That's all, stop editing! Happy blogging. */ 。 保存更改後，WordPress 調試模式將處於活動狀態。 您還可以在文件中添加更多行。 例如，您可以使用以下內容創建專用的書面 debug.log 文件：

define( 'WP_DEBUG_LOG', true );

不過，請記住使用false值而不是true禁用WP_DEBUG 。 作為替代方案，您可以從wp-config.php文件中刪除相關行並重新保存更改。

2. 使用專用插件啟用 WordPress 的調試模式

您還可以使用插件來啟用調試模式。 如果您不願意在核心文件中四處尋找，這會使該過程更易於訪問。 最佳解決方案是 WP 調試：

WP 調試插件。

安裝並激活插件後，它就已經開始工作了。 它在您的wp-config.php中啟用以下“常量”：

 define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'SCRIPT_DEBUG', true ); define( 'SAVEQUERIES', true );

您已經使用了前兩個常量。 SCRIPT_DEBUG切換 WordPress 以使用核心 CSS 和 JavaScript 文件的開發版本。 在正常情況下，WordPress 會使用壓縮文件，這在極少數情況下會導致問題。 如果您正在尋找錯誤，這不會影響您，但如果您是開發人員，則可以這樣做。

SAVEQUERIES也是一個以開發人員為中心的常量，它將數據庫查詢存儲在一個全局數組 ( $wpdb->queries ) 中。 它將存儲查詢本身、執行時間以及調用它的函數。 它還會對性能產生影響，因此如果您使用該插件，則應牢記這一點。 如果上述內容對您來說意義不大，請知道這對您的體驗沒有太大影響。

安裝插件後，您會注意到您可能還需要安裝其他插件：

WordPress 後端的管理員通知。

事實上，除非您是需要完成特定任務的開發人員，否則這些都不是必需的。

插件選項很少，這有助於提高可用性。 您可以在 WordPress 的Tools > WP Debugging菜單下找到設置，共有三個選項：

  • 啟用WP_DEBUG 。
  • 將WP_DEBUG_DISPLAY設置為 false。 這將在您的網站上顯示或隱藏通知，與您的日誌是否錯誤無關。
  • WP_DISABLE_FATAL_ERROR_HANDLER切換為 true。 如果您不知道這意味著什麼，您應該不理會它，因為它會更頻繁地導致 WSoD。

如果您想查看日誌，可以通過Debug Quick Look菜單進行：

調試快速查看欄。

該插件是一種無需深入研究核心文件即可調試站點的便捷方式，因此值得安裝。 當然，您需要在完成後卸載插件或停用選項，就像手動方法一樣。

包起來

WordPress 網站出現故障的情況很少見，或者至少當它發生時您能夠修復它。 大多數重大錯誤會通過您網站上的通知或加載網站時的頁面顯示出來。 但是，您可能需要了解許多其他“無聲的”錯誤或問題，尤其是如果您是開發人員。

在這篇文章中，我們為您提供了兩種激活 WordPress 調試模式的方法。 他們又來了：

  • 使用 SFTP 打開您的wp-config.php文件並添加幾行代碼。
  • 安裝一個插件，例如 WP Debugging，並以一種輕鬆的方式記錄您的錯誤。

您是否需要使用 WordPress 調試模式，這篇文章對您有幫助嗎？ 在下面的評論部分讓我們知道！