WordPress除錯完整指南(啟用WP_DEBUG + 其他工具)

WordPress除錯完整指南(啟用WP_DEBUG + 其他工具)

在一個完美的世界中,您永遠不會遇到需要除錯的問題。但在現實世界中,您幾乎肯定會在WordPress網站上遇到需要深入瞭解的問題。

為了幫助您做到這一點,WordPress包含其自己的內建除錯模式,您還可以找到有用的第三方工具來幫助您除錯WordPress。

在這篇文章中,我們將深入研究內建的WordPress除錯模式並向您展示如何啟用它。然後,我們還將分享其他一些除錯WordPress網站的方法。

這是我們將涵蓋的所有內容:

WP Debug有什麼作用?

核心WordPress軟體是用PHP編寫的,外掛和主題也是如此。

如果您的網站出現問題,WordPress Debug模式可以通過顯示所有PHP錯誤、通知和警告來幫助您找出問題所在。

啟用Debug模式後,只要出現問題(即使它不會立即引起問題),您就會看到如下訊息:

WordPress網站上的WP_DEBUG錯誤示例

WordPress網站上的WP_DEBUG錯誤示例

然後,您可以修復問題或將其報告給您的開發人員或主題/外掛的開發人員。

什麼是WordPress除錯日誌?

當你本身啟用WordPress的除錯模式,你會看到的訊息像上面網站上的例子在那一刻-但這些訊息不會被儲存任何地方。

如果您想儲存它們,您還可以啟用WordPress除錯日誌以將所有這些訊息和錯誤儲存到您伺服器上的檔案中。

通過將WP_DEBUG_LOG常量設定為true啟用後,WordPress會將所有問題寫入以下檔案:

wp-content/debug.log

但是,您也可以指定自定義檔案路徑以將日誌寫入伺服器上的其他位置。

如果您想將問題儲存到日誌中但不想在頁面的HTML中公開顯示它們(如上面的示例螢幕截圖),您還可以使用WP_DEBUG_DISPLAY常量來保持啟用除錯模式但不在您的站點上顯示訊息。

通常,您需要WP_DEBUG_DISPLAYWP_DEBUG_LOG.

如何啟用WordPress Debug模式

要啟用WordPress除錯模式,您有多種選擇。我們將介紹三種啟用它的方法:

  1. 如何使用WordPress除錯外掛
  2. 如何手動啟用WordPress除錯模式

如何使用WordPress除錯外掛

您可以使用免費的WordPress除錯外掛,啟用除錯模式。WordPress.org上有幾個選項,但我們推薦Andy Fragen提供的免費WP Debugging外掛

WP Debugging外掛

WP Debugging外掛

安裝並啟用外掛後,它會立即開始工作。預設情況下,它將以下常量設定為true(即啟用以下功能):

  • WP_DEBUG – 啟用除錯模式。
  • WP_DEBUG_LOG – 將訊息儲存到日誌檔案。
  • SCRIPT_DEBUG
  • SAVEQUERIES

我們將在本文稍後介紹最後兩個常量的作用。

要配置一些選項,您可以轉到工具 → WP Debugging:

WP Debugging外掛設定

WP Debugging外掛設定

完成後,請確保禁用外掛以禁用除錯模式。

如何手動啟用WordPress除錯模式

最後,您還可以通過手動將常量新增到wp-config.php檔案來啟用WordPress除錯模式。

首先,通過FTP連線到您的伺服器並編輯wp-config.php檔案。預設情況下,此檔案位於您站點的根資料夾中(除非您出於安全原因移動了它)。

要啟用只是基本的WordPress的除錯模式,新增下面的程式碼片段上面寫著/* That’s all, stop editing! Happy blogging. */:

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
// Enable WP_DEBUG modedefine( 'WP_DEBUG', true );
// Enable WP_DEBUG modedefine( 'WP_DEBUG', true );
// Enable WP_DEBUG modedefine( 'WP_DEBUG', true );

您還可以根據自己的喜好使用以下一些常量:

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
// Enable Debug logging to the /wp-content/debug.log filedefine( 'WP_DEBUG_LOG', true );// Disable display of errors and warningsdefine( 'WP_DEBUG_DISPLAY', false );@ini_set( 'display_errors', 0 );
// Enable Debug logging to the /wp-content/debug.log filedefine( 'WP_DEBUG_LOG', true );// Disable display of errors and warningsdefine( 'WP_DEBUG_DISPLAY', false );@ini_set( 'display_errors', 0 );
// Enable Debug logging to the /wp-content/debug.log filedefine( 'WP_DEBUG_LOG', true );// Disable display of errors and warningsdefine( 'WP_DEBUG_DISPLAY', false );@ini_set( 'display_errors', 0 );

完成後,您可以將常量設定為false或僅刪除程式碼段以禁用除錯模式。

確保在完成後禁用WordPress中的除錯模式

除錯模式在您嘗試解決WordPress問題時很有用,但您不應該讓它24/7全天候啟用,因為它可以將您的PHP程式碼中的文字顯示給網站訪問者。

我們在上面提到了這一點 – 但這只是提醒您在完成故障排除後始終禁用除錯模式。

其他除錯WordPress的方法

除了我們上面介紹的內建除錯工具之外,還有其他幾個內建和第三方工具可以幫助您除錯WordPress網站。

指令碼除錯

SCRIPT_DEBUG是另一個內建常量,它強制WordPress使用核心CSS和JavaScript檔案的開發版本,而不是它通常載入的縮小版本。

如果您正在測試對內建 .js 或.css檔案的更改,這會很有幫助。

要啟用SCRIPT_DEBUG,您可以:

  • 使用上面的免費WP Debugging外掛,預設情況下啟用它。
  • 將以下常量新增到您的wp-config.php檔案中 –define( 'SCRIPT_DEBUG', true );

資料庫查詢除錯

如果您的站點的資料庫有問題,您可以使用SAVEQUERIES常量來啟用資料庫查詢日誌記錄:

  • 每個資料庫查詢。
  • 呼叫資料庫查詢的函式。
  • 查詢用了多長時間。

要啟用查詢日誌記錄,您可以:

  • 使用上面的免費WP Debugging外掛,預設情況下啟用它。
  • 將以下常量新增到您的wp-config.php檔案中 –define( 'SAVEQUERIES', true );

注意:這會影響您網站的效能,因此請儘可能在臨時網站上使用它,並在完成後立即將其禁用。

Query Monitor外掛

Query Monitor外掛是一個免費的外掛,這對在WordPress包括除錯許多不同的領域有所幫助:

總的來說,它是您能找到的最好的WordPress除錯工具之一,這就是為什麼它在320多條評論中幾乎獲得了完美的5星評級。

安裝並啟用外掛後,您將在WordPress工具欄上獲得一些顯示除錯資訊的新選項。單擊後,這些選項將開啟一個新的Query Monitor框,為您提供更多資訊:

Query Monitor外掛

Query Monitor外掛

為了更詳細地瞭解,我們有一整篇關於如何使用Query Monitor外掛的文章

New Relic

New Relic是用於分析和除錯站點效能的高階工具。它可以幫助您發現影響站點效能的瓶頸和問題。

伺服器日誌

最後,您的伺服器日誌也可以成為除錯WordPress的有用工具。

如果您在使用寶塔面板,也可以輕鬆查詢伺服器日誌,參考寶塔面板日誌查閱教程

小結

如果您需要除錯WordPress,內建的WordPress除錯模式提供了一種檢視PHP錯誤和通知的有用方法。

您可以使用外掛或通過將程式碼片段新增到您網站的wp-config.php檔案來啟用它。

如需更多幫助,您還可以使用其他內建工具或第三方工具,例如New Relic和免費的Query Monitor外掛。

評論留言