WordPressの debug.log が見つからないときは、ファイルを先に作るより、設定が読み込まれたか、どこへ書く設定か、ログを出す処理が通ったかを順に確認します。設定を有効にしただけで、必ず空のログファイルが作られるとは限りません。
まず検証環境で確認してください。WordPress公式は、デバッグ機能をローカルやステージング向けとし、本番での利用を推奨していません。本番障害で調査が必要な場合も、管理者と実施範囲を決め、保存先の保護と設定の復旧まで含めて扱います。S1
出ない原因を、設定・書き込み・処理の三つに分ける
| 確認すること | 見る場所 | 分かった後の進め方 |
|---|---|---|
| 設定が有効か | 対象サイトが読み込むwp-config.phpと定数の値 | 重複や記述位置を確認する |
| どこへ保存するか | WP_DEBUG_LOGとWP_CONTENT_DIR | 別の保存先を探す |
| 書き込めるか | 親フォルダ、PHP実行ユーザー、容量 | 必要な権限と保存領域を管理者へ確認する |
| ログ対象の処理が通るか | 再現操作、リクエストの時刻 | 検証用の短い記録で経路を確認する |
| WordPressまで起動するか | PHP・Webサーバー側のログ | 起動前のエラーを調べる |
この表は、同じエラーを繰り返し起こすためのものではありません。ログを待って何度も注文やメール送信を試すと、二重処理につながる場合があります。副作用のない操作で調べられるかを先に考えます。
WP_DEBUGとWP_DEBUG_LOGを別々に確認する
WP_DEBUG_LOG は、WP_DEBUG が有効なときに働きます。画面へ表示するかは WP_DEBUG_DISPLAY の役割なので、画面にエラーが出ないことだけでは、ファイルへの記録が止まっていると判断できません。S2
検証環境で使う基本例です。既存の定義を探して値を調整し、同じ定数を追加で重ねないようにします。編集前には設定ファイルの控えを用意してください。
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
true と false は引用符を付けない真偽値です。文字列の 'false' を書く方法と混同しないようにします。設定はWordPressの起動処理より前、通常は wp-config.php の編集終了を示すコメントより前に置きます。S1
変更したファイルが、調査対象サイトのものかも確認してください。同じサーバーに本番と検証用のWordPressがある場合や、コンテナへ設定を渡している場合は、手元のファイルを変えても稼働側へ反映されていないことがあります。
構文エラーがあると、ログ設定が有効になる前に処理が止まる可能性があります。編集で画面が動かなくなったら、変更を重ねず、控えへ戻す方法とPHP側のエラーログを確認します。
保存先は、必ずしもwp-content/debug.logではない
WP_DEBUG_LOG が true の標準処理では、WP_CONTENT_DIR の下の debug.log が保存先です。WP_CONTENT_DIR を変更しているサイトなら、一般的な場所を探すだけでは見つかりません。文字列のパスが指定されている場合は、そのファイルへ記録する設定になります。S2
たとえば次は、Web公開領域の外に保存場所を用意した場合の指定例です。パスは架空の例なので、そのまま追加しないでください。 実際に非公開であること、親フォルダが存在すること、PHPが書き込めることを先に確認します。
define( 'WP_DEBUG_LOG', '/srv/site-logs/wp-debug.log' );
これは先ほどの WP_DEBUG_LOG の行を置き換える例です。二つ同時には定義しません。WP_DEBUG と画面表示の設定は別に確認します。
保存先が分かったら、ファイルの有無だけでなく、PHPを動かすユーザーが親フォルダへ書き込めるか、容量やクォータが不足していないかを調べます。SSHでログインするユーザーが書けることと、WebのPHPが書けることは同じではありません。
原因が分からないままフォルダを誰でも書ける権限へ変えたり、サイト全体の所有者を変更したりしないでください。ホスティング側の指定に合わせて、必要な場所だけを管理者と確認します。
検証環境で、既知の一行が書かれるかを見る
ログの経路だけを確かめたいなら、顧客データを含まない固定文字列を使います。PHPの error_log() は、通常、設定されたPHPのログ出力先へメッセージを送ります。WordPressがログ設定を反映した後なら、指定されたファイルへ記録されるかを確かめられます。S3
次は、検証環境の一時的なプラグインなど、WordPress起動後に通る場所へ置く確認用の一行です。単独の公開PHPファイルを作ってアクセスする方法ではありません。
error_log( 'wp-log-check: staging-only' );
一度操作した時刻を控え、保存先でこの文字列を探します。確認が済んだら一行を削除し、設定も元へ戻します。名前、リクエスト内容、認証情報を文字列へ追加する必要はありません。
この一行は書かれるのに元の問題の記録がない場合は、対象処理を通っていない、別のリクエストで起きている、例外が別の仕組みで処理されている、といった可能性を調べます。ブラウザ内のJavaScriptだけで起きたエラーが、PHPのログに必ず載るわけでもありません。
一行も書かれない場合は、設定の反映先、保存先、権限を戻って確認します。ファイルを手動で作れたことを、PHPから記録できる証拠にはしないようにします。
PHPのエラーログとは、出力先と起動段階を分けて考える
debug.log は、PHPのログと無関係な別システムではありません。WordPressの標準処理は、条件に応じてPHPの log_errors と error_log を設定します。同じリクエストの中でも、WordPressが設定する前と後で、参照するログが違う場合があります。S2
| 状況 | 次に確認するもの |
|---|---|
| WordPressが起動した後のPHP警告 | 指定したWordPressのログ保存先 |
| wp-config.phpの構文など、起動前の問題 | ホスティングのPHPエラーログ |
| PHPプロセスやWebサーバーの障害 | PHP-FPM等の運用ログ、Webサーバーログ |
| ブラウザ側のJavaScriptだけの問題 | 開発者ツールのConsoleやNetwork |
サーバーのログ名や閲覧方法は契約先によって異なります。問い合わせるときは「debug.logがない」だけでなく、対象URL、発生時刻とタイムゾーン、PHPの版、設定した保存先を伝えます。ログ自体は公開せず、必要な行から秘密情報を除いて共有してください。
PHPの変更直後に起きた問題なら、WordPressのPHP更新前後に確認する互換性と動作も照合できます。コードの修正が必要になった場合は、AIを使う既存コード改修の確認手順で、変更範囲と期待する動作を先に整理します。
調査後は、デバッグ設定を元へ戻し、ログのアクセス制限、保管期間、削除方法を確認します。画面へ表示しない設定だけでは、ログファイルそのものの公開を防げません。
対象はWordPress 6.x・7.xの標準的なデバッグ設定、PHP 8.3系を想定した確認例です。公式資料の確認日は2026年11月23日。PHP例の構文確認と、WordPress上でのログ生成の再現試験は区別し、後者は実施していません。Mac・Windowsでも、書き込み権限はPHPが動くサーバー側で確認してください。
出典
- https://developer.wordpress.org/advanced-administration/debug/debug-wordpress/ WordPress Developer Resources「Debugging in WordPress」(確認日: 2026-11-23) ↩1 ↩2
- https://developer.wordpress.org/reference/functions/wp_debug_mode/ WordPress Code Reference「wp_debug_mode」(確認日: 2026-11-23) ↩1 ↩2 ↩3
- https://www.php.net/manual/en/function.error-log.php PHP Manual「error_log」(確認日: 2026-11-23) ↩1