管理 WordPress 網(wǎng)站時，遇到白屏、功能失效或頁面加載問題是相對常見的現(xiàn)象。這時，WordPress 的調(diào)試功能就顯得非常重要。WordPress 內(nèi)置了調(diào)試工具，可以通過啟用調(diào)試日志來捕捉錯誤并幫助我們識別并解決問題。

本文將詳細介紹如何啟用和使用 WordPress 的調(diào)試日志，并展示如何更有效地利用調(diào)試功能來排查網(wǎng)站問題。

---

1. 查找并啟用 WordPress 調(diào)試日志 (wp-config.php)

WordPress 的調(diào)試功能是通過修改 wp-config.php 文件來啟用的。這個文件位于網(wǎng)站的根目錄中，控制著 WordPress 的基本配置。通過啟用調(diào)試日志，我們可以將所有錯誤信息記錄在文件中，方便后續(xù)的排查。

步驟：

1. 使用 FTP 客戶端（如 FileZilla）或通過主機的文件管理工具連接到服務(wù)器。
2. 在根目錄（通常是 public_html 或 www 文件夾）中找到 wp-config.php 文件。
3. 下載該文件并用文本編輯器（如 Notepad++）打開。

4. 在文件中，找到類似 define( 'WP_DEBUG', false ); 的行，將 false 改為 true。如果該行不存在，可以手動添加：define( 'WP_DEBUG', true );
5. 保存并上傳該文件，替換原來的 wp-config.php 文件。

此操作啟用了 WordPress 的基本調(diào)試功能。如果頁面有錯誤，錯誤信息將顯示在前臺頁面上。這對開發(fā)人員有幫助，但如果網(wǎng)站已經(jīng)上線并對公眾開放，建議將錯誤記錄在日志中而不是直接顯示。

2. 用于調(diào)試的可選 PHP 常量

在啟用調(diào)試模式的基礎(chǔ)上，還可以通過修改 wp-config.php 添加更多控制選項。這里有兩個非常重要的 PHP 常量，能讓調(diào)試日志更好地服務(wù)于開發(fā)和排查問題。

WP_DEBUG_DISPLAY

此常量控制是否在前端顯示調(diào)試信息。如果網(wǎng)站正在公開運行，建議將其關(guān)閉，以免暴露網(wǎng)站詳細信息給訪客或潛在攻擊者。

define( 'WP_DEBUG_DISPLAY', false );

WP_DEBUG_LOG

這個常量允許我們將調(diào)試信息記錄在日志文件中，而不是直接顯示在網(wǎng)頁上。當啟用后，所有調(diào)試信息將記錄在 wp-content/debug.log 文件中。

define( 'WP_DEBUG_LOG', true );

完整的配置示例如下：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_DEBUG_LOG', true );


通過這樣的設(shè)置，可以確保調(diào)試信息只存儲在日志中，而不會顯示在前端，避免暴露敏感信息。

3. 如何查看 WordPress 調(diào)試日志

啟用調(diào)試日志后，所有錯誤信息將記錄在 wp-content/debug.log 文件中。這個日志文件記錄了發(fā)生的所有 PHP 錯誤、警告和通知。查看日志有助于理解問題的根源，尤其是在插件或主題引發(fā)問題時。

步驟：

1. 使用 FTP 客戶端或主機文件管理工具進入 wp-content 文件夾。

2. 找到 debug.log 文件，右鍵下載到本地。
3. 使用文本編輯器打開該文件，查看記錄的錯誤、警告和通知。

調(diào)試日志中的每一行都會包含時間戳、錯誤等級和錯誤信息，幫助你識別問題所在。例如：

[28-Jul-2024 20:28:17 UTC] PHP Deprecated:  Using ${var} in strings is deprecated, use {$var} instead in /home/website/public_html/wp-content/plugins/admin-notices-manager/includes/functions/core.php on line 136

此日志記錄告訴我們插件代碼中使用了過時的 PHP 語法，需要進行更新。可以根據(jù)日志中的提示，找到問題所在的文件和代碼行，并進行修復(fù)。

4. 安裝插件以自動化 WordPress 調(diào)試報告

如果你不想每次手動查看調(diào)試日志，或者希望更簡化的調(diào)試流程，可以使用一些插件來自動化調(diào)試日志記錄和顯示。Error Log Monitor 就是一個非常簡單有效的插件，它可以幫助你在 WordPress 儀表板中直接查看錯誤日志。

步驟：

1. 登錄到 WordPress 儀表板，導(dǎo)航到 插件 -> 添加新插件。
2. 在搜索欄中輸入“Error Log Monitor”，然后點擊 安裝。

3. 安裝完成后，點擊 激活。
4. 在儀表板的“工具”菜單下，會看到一個新選項卡“錯誤日志”，可以直接查看錯誤日志。
5. 點擊“配置”按鈕，可以自定義通知頻率等設(shè)置，以更好地管理調(diào)試日志。

這個插件使得調(diào)試報告的自動化變得更加簡單，無需每次通過 FTP 下載日志文件。

總結(jié)

啟用 WordPress 調(diào)試模式并使用調(diào)試日志是解決網(wǎng)站問題的重要步驟。通過在 wp-config.php 中啟用 WP_DEBUG 和 WP_DEBUG_LOG，可以將所有錯誤記錄在日志文件中，方便后續(xù)查看和處理。使用像 Error Log Monitor 插件可以進一步簡化日志管理，更輕松地掌握網(wǎng)站的運行狀態(tài)并快速排查問題。

聯(lián)系我們
教程看不懂？聯(lián)系我們?yōu)槟赓M解答！免費助力個人，小企站點！	客服微信
① 電話：020-2206-9892
② QQ咨詢：1025174874
③ 郵件：info@361sale.com
④ 工作時間：周一至周五，9:30-18:30，節(jié)假日休息