當 WordPress 網站出現問題時,開啟 Debug 模式可以幫助我們找出錯誤的根源。這篇文章將帶您一步步了解如何啟用 WordPress 的除錯功能。
什麼是 WordPress Debug 模式?
WordPress Debug 是一個內建的除錯工具,它能夠顯示網站運行時的錯誤訊息和警告。當網站發生問題時,這些資訊能幫助開發者快速找出問題所在。
啟用 Debug 模式的步驟說明
步驟一:備份 wp-config.php
在開始之前,請務必先備份您的 wp-config.php 檔案,以防萬一:
1. 連接到您的 WordPress 網站伺服器
2. 找到根目錄下的 wp-config.php 檔案
3. 下載一份備份檔案到您的電腦
步驟二:編輯 wp-config.php
使用檔案編輯器(如 Visual Studio Code )開啟 wp-config.php 檔案。
步驟三:加入除錯程式碼
在檔案中尋找 /* That's all, stop editing! Happy publishing. */
這行程式碼,在它的上方加入以下程式碼:
// 開啟 WordPress Debug 模式
define( 'WP_DEBUG', true );
// 啟用 Debug Log 記錄
define( 'WP_DEBUG_LOG', true );
// 關閉直接顯示錯誤訊息在網頁上
define( 'WP_DEBUG_DISPLAY', false );
步驟四:設定檔案權限
1. 確認 wp-content 資料夾具有寫入權限
2. Debug log 檔案會自動建立在 wp-content/debug.log
3. 建議將 debug.log 的權限設為 644
步驟五:測試除錯功能
完成設定後:
1. 重新整理您的 WordPress 網站
2. 檢查 wp-content 資料夾中是否出現 debug.log 檔案
3. 查看檔案內容,確認是否正確記錄錯誤訊息
重要注意事項
1. 安全性考量:
– 請勿在正式運行的網站上長期開啟 Debug 模式
– 除錯完成後記得關閉此功能
– 定期清理 debug.log 檔案以節省空間
2. 疑難排解:
– 如果找不到 debug.log 檔案,請檢查資料夾權限
– 確認 PHP 有寫入權限
– 檢查伺服器設定是否允許記錄檔案
如何關閉 Debug 模式
完成除錯後,建議關閉 Debug 模式:
// 關閉 WordPress Debug 模式
define( 'WP_DEBUG', false );
// 關閉 Debug Log 記錄
define( 'WP_DEBUG_LOG', false );
// 關閉錯誤顯示
define( 'WP_DEBUG_DISPLAY', false );
結語
WordPress Debug 模式是解決網站問題的重要工具。透過正確的設定,您可以更容易找出並解決網站問題。記住,除錯完成後要關閉這個功能,以確保網站的安全性和效能。
如果您在設定過程中遇到任何問題,建議尋求專業的 WordPress 開發者協助,以確保網站能夠正常運作。