はじめに
WordPressでエラーが発生した際、エラーの詳細を把握するには「デバッグモード」を有効にする必要があります。wp-config.php に数行追加するだけで、PHPエラーの内容・ファイル名・行番号をログに記録できます。
デバッグ関連の定数一覧
wp-config.php で使えるデバッグ関連の定数：
| 定数名 | 役割 |
|--------|------|
| WP_DEBUG | デバッグモードのON/OFF（true/false） |
| WP_DEBUG_LOG | エラーをログファイルに記録する |
| WP_DEBUG_DISPLAY | エラーを画面に表示する |
| SCRIPT_DEBUG | 未圧縮のJS/CSSを読み込む |
| SAVEQUERIES | データベースクエリを記録する |
設定手順
ステップ1：wp-config.phpをFTPでダウンロード
FTPで WordPressルートディレクトリ（public_html/ 直下など）の wp-config.php をダウンロードします。
ステップ2：デバッグ設定を追加
wp-config.php の中に既存の define('WP_DEBUG', false); を探して書き換えます：
開発環境向け（エラーを画面表示）：
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );
define( 'WP_DEBUG_LOG', true );本番環境向け（エラーをログのみ記録・画面非表示）：
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_DEBUG_LOG', true );
@ini_set( 'display_errors', 0 );ステップ3：エラーログを確認する
設定後、wp-content/debug.log にエラーが記録されます。FTPでダウンロードしてテキストエディタで開きます。
ログの例：
[13-May-2025 10:23:45 UTC] PHP Fatal error: Uncaught Error:
Call to undefined function my_old_function() in
/wp-content/themes/my-theme/functions.php:42「on line 42」の部分が問題の行番号です。
ステップ4：問題解決後はデバッグモードをOFFに
必ず本番環境ではデバッグモードをOFFに戻してください。
define( 'WP_DEBUG', false );デバッグモードONのまま放置すると、エラー情報が画面に表示されてセキュリティリスクになります。また debug.log ファイルが肥大化する可能性があります。
debug.logが大きくなりすぎた場合
# FTPまたはSSHでdebug.logを削除（WordPressが自動で再作成します）
rm wp-content/debug.log注意事項
WP_DEBUG_DISPLAYをtrueにしている場合、サイト訪問者にもエラーが見えます- 本番環境での使用は短時間にとどめ、問題解決後は必ず
falseに戻してください debug.logには機密情報（データベース情報等）が含まれる場合があるため、.htaccessでアクセス制限することを推奨します
まとめ
デバッグモードは wp-config.php に WP_DEBUG = true を設定するだけで有効になります。WP_DEBUG_LOG = true にすると wp-content/debug.log にエラーが記録されます。問題解決後は必ずOFFに戻しましょう。
関連記事：