WordPressのエラーログ(debug.log)は、記録を有効にすると、通常 wp-content/debug.log に保存されます。
画面に表示せず調べるには、wp-config.phpでデバッグログを有効にし、エラー表示を無効にします。
この記事では設定の貼り付け位置、ログの読み方、ファイルが作られない場合の確認順を説明します。
対象はPHP側のエラー調査です。
CSSが反映されない、スライダーのボタンが動かないといった症状では、ブラウザ側の確認も必要です。
まず下の表で調べる場所を選んでください。
症状から調べる場所を選ぶ
| 症状 | 最初の確認 |
|---|---|
| 重大なエラー・白い画面・500エラー | 直前の変更と発生時刻を記録。PHPログ、サーバーのエラーログを確認します。 |
| CSSだけ反映されない・見た目が崩れる | ブラウザの開発者ツールでCSSの読み込み、セレクター、上書き、キャッシュを確認します。 |
| ボタン・開閉・スライダーが動かない | 開発者ツールのConsoleとNetworkでJavaScriptエラーや読み込み失敗を確認します。 |
| Ajax・REST APIの処理が失敗する | NetworkのHTTPステータス・応答と、同じ時刻のPHPログを照合します。 |
| 管理画面にも入れない | サーバー管理画面やSFTPから変更を戻せるか確認します。WordPress内の編集画面だけに頼らないでください。 |
編集前にwp-config.phpを保存する
先にバックアップと復元方法を確認し、編集前のwp-config.phpを手元に保存します。
このファイルにはデータベースの接続情報などが含まれるため、記事・掲示板・公開フォルダーへコピーを置かないでください。
サーバーのファイル管理機能またはSFTPで、編集したファイルを元に戻せる状態にします。
調査は検証用サイトで行うことを基本にします。
WordPress公式も、デバッグ機能はローカル・ステージング環境で使うことを推奨しています。
本番固有の症状を一時的に調べる場合も、ログの保存先と非公開化、調査を終える時刻を決めてから設定します。
画面に表示せずdebug.logへ記録する設定
wp-config.php内の WP_DEBUG、WP_DEBUG_LOG、WP_DEBUG_DISPLAY を検索します。
すでに定義があれば、その行を書き換えます。
同じ定数の定義を末尾へ追加しても、先に定義された値を変更できません。
定義がない場合は「編集が必要なのはここまでです」または That's all, stop editing! のコメントより前に追加します。
少なくとも wp-settings.php を読み込む行より前に置きます。
functions.phpやCode Snippetsへ貼る設定ではありません。
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );既存のPHPコード内に入れるため、上の例にPHP開始タグは含めていません。
true と false に引用符を付けないでください。
文字列の 'false' は真として扱われ、意図と逆の設定になります。
WP_DEBUG はデバッグ報告、WP_DEBUG_LOG はログの保存先、WP_DEBUG_DISPLAY は画面表示を制御します。
@ini_set も実行時の表示設定を変更しますが、サーバー側の固定設定や、この行が実行される前のエラーまで隠せる保証にはなりません。
@ 自体がサイト全体のエラーを抑えるものでもありません。
設定の根拠:WordPress公式のデバッグ手順、PHP公式のエラー表示・ログ設定。
本番のPHP設定では、サーバー側でもエラーの画面表示を無効にしておきます。
エラーログの場所と非公開の保存先
WP_DEBUG_LOG を true にすると、通常はWordPressの wp-content/debug.log に記録されます。
wp-contentの場所を変更した環境では、そのディレクトリ内を確認します。
記録対象が発生し、PHPに書き込み権限がある場合にファイルが作成されます。
設定するだけで必ず空のファイルができるわけではありません。
debug.logにはファイルパスや個人情報が含まれることがあります。
Webから直接読める場所へ無防備に残さず、可能なら公開ディレクトリの外に保存します。
次の例はLinux系サーバーの仮のパスです。
実在する非公開ディレクトリと、PHPが書き込める権限を確認して置き換えてください。
// 前の WP_DEBUG_LOG の行を置き換えます。重複して追加しません。
define( 'WP_DEBUG_LOG', '/home/ACCOUNT/private-logs/wordpress-debug.log' );親ディレクトリを自動作成する設定ではありません。
保存先が分からない場合は契約サーバーへ確認します。
ログはSFTPやサーバー管理画面から取得し、公開URLを調査用の共有先にしないでください。
保存先の扱いはWordPressの実装でも確認できます。
公開領域にログを置く場合のApache設定
公開領域外へ保存できない場合は、サーバー側でログファイルの取得を拒否します。
次の例はApache 2.4用で、WordPressのwp-content内の.htaccessに置きます。
既存ファイルを保存し、同じ設定がないか確認してから追記してください。
Requireを.htaccessで使える許可設定(AllowOverride AuthConfigなど)が必要です。
Nginxには適用できないため、ホストのアクセス制限機能を使います。
500エラーになった場合は追加部分を戻してサーバーログを確認します。
隔離したApache 2.4.69では、WP_DEBUG_DISPLAY=falseでも標準ログのURLは200で読めました。
この拒否設定を加えると403になりました。
設置後は認証していないGET要求でログURLを確認し、本文を取得できないことを確かめます。
調査後もログが公開領域に残る間は拒否設定を維持してください。
参照:ApacheのFiles、Require。
<Files "debug.log">
Require all denied
</Files>
Nginxの検証環境で確かめた結果
2026年10月30日に、WordPressの開発環境「Local」(Nginx 1.26.1、PHP 8.2.29、WordPress 7.1.4)で、この記事の設定をそのまま試しました。
wp-config.phpの「stop editing」のコメントより前に4行を足し、存在しない配列キーを読むだけの検証用コードで警告を1回出しています。
| 確かめたこと | 結果 |
|---|---|
| 画面の表示 | ページはHTTP 200で開き、警告の文は画面に出なかった |
| ログの場所 | wp-content/debug.log が作られ、警告が1行記録された(183バイト) |
| ログの時刻 | 日本時間の18時34分の出来事が「09:34:38 UTC」と協定世界時で記録された |
| URLからの取得 | /wp-content/debug.log をブラウザーと同じ方法で要求すると、HTTP 200で中身を取得できた |
| 設定を戻した後 | 同じ操作をしてもログは更新されず、前の1行が残ったままだった |

記録された1行は次のとおりです(ユーザー名とサイト名は伏せています)。
[30-Oct-2026 09:34:38 UTC] PHP Warning: Undefined array key "label" in C:\Users\(ユーザー名)\Local Sites\(サイト名)\app\public\wp-content\mu-plugins\cgm-debuglog-test.php on line 6ログには、PCやサーバー上のフォルダーの絶対パスがそのまま入りました。
Nginxでは上のApacheの拒否設定が効かないため、検証環境でもログのURLから中身を読める状態でした。
公開しているサーバーがNginxなら、ログを公開領域の外に保存するか、契約サーバーのアクセス制限の機能で拒否してください。
確かめ終えた後は、編集前に控えたwp-config.phpに戻し、検証用コードとdebug.logを削除しました。
再現操作とログの読み方
- 発生したページ・操作・時刻と、直前に変更したテーマやプラグインを記録します。
- 検証環境で同じ操作を1回行い、ログの更新日時を確認します。キャッシュ済み画面を表示しただけではPHP処理が実行されない場合があります。
- 時刻が近い行から、エラー種別・メッセージ・ファイル名・行番号を読みます。ログのタイムゾーンと手元の時計の違いにも注意します。
- 直前の変更を1つずつ戻して再確認します。ログに出たファイル名だけで原因を断定せず、呼び出し元や入力値も調べます。
以下は読み方を説明するための架空のログです。
WAZAで発生した障害の記録ではありません。
[30-Sep-2026 01:00:00 UTC] PHP Warning: Undefined array key "label" in /example/wp-content/plugins/example-plugin/example.php on line 42この例は、example.phpの42行目で配列のlabelというキーが見つからなかったことを示します。
その行を削除するのではなく、値が入る想定と未入力時の処理を確認します。
Fatal errorは処理停止につながるエラー、Warningは警告、Deprecatedは非推奨機能の通知です。
警告と現在の画面不具合が同じ原因とは限りません。
debug.logが作られない・更新されない場合
- WP_DEBUGがtrueになっているか、同じ定数を2回定義していないか、wp-settings.phpの読み込みより前に置いたかを確認します。
- 独自の保存先を指定していないか、正しいサイトのwp-config.phpを編集したかを確認します。
- 問題の処理が実際に実行されたか確認します。JavaScriptだけのエラーやCSSの競合は、このPHPログの対象ではありません。
- 保存先の親ディレクトリ、PHPの書き込み権限、サーバーの空き容量を確認します。原因不明のまま権限を777へ変更しないでください。
- wp-config.php自体の構文エラーなど、WordPressのログ設定が動く前に停止していないか、サーバー側のPHP・Webサーバーログを確認します。
ログが空でも「不具合がない」とは判断できません。
別のログ出力先を使うプラグインや、独自のエラー処理を行うコードもあります。
500エラーだけでは原因を特定できないため、発生時刻とサーバーログを照合してください。
調査後は設定を戻し、古いログも整理する
調査前の設定がある場合は、それに戻します。
一般的なデバッグ無効の構成へ戻す例は次のとおりです。
調査用の定義を下記に置き換え、重複して追加しないでください。
define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );設定を無効にしても既存のdebug.logは消えません。
必要な調査記録を非公開の場所へ保存したうえで、公開領域に残ったログを整理します。
サーバー側の通常のエラーログまで停止する設定ではありません。
復旧後はトップページ、問題が起きた操作、管理画面を確認します。
管理画面に入れなくなった場合は、SFTPやサーバーのファイル管理機能から編集前のwp-config.phpへ戻します。
バックアップ全体の復元は記事や注文なども上書きし得るため、まず変更したファイルだけを戻せるか確認してください。
次に確認する手順
検証環境からの反映は本番反映の注意点、変更前の保全はバックアップ・復元ガイドへ進んでください。
実装方式や貼り付け先を調べ直す場合はSWELLカスタマイズまとめから該当記事を探せます。
動作確認:2026年10月3日。
隔離環境のPHP 8.2.29で、WordPress 7.1.2のログ初期化処理と掲載の定数設定を実行しました。
警告が画面へ出ず標準・非公開の保存先へ記録されること、保存先の親ディレクトリが自動作成されないこと、デバッグ無効でもサーバー側のログは残ることを確認しています。
2026年10月30日には、LocalのNginx環境でも記録・非表示・URLからの取得・設定を戻した後の挙動を確かめました。
本番設定やプラグイン固有のログ出力は変更・検証していません。
よくある質問:WordPressのエラーログの場所と出力方法
PHPのエラーを、画面に表示せずに調べるには、どうしますか?
記事では、wp-config.phpでデバッグログを有効にし、エラー表示を無効にします。
標準の保存先は通常、wp-content内のdebug.logです。
この記事は、設定の貼り付け位置、ログの読み方、ファイルが作られない場合の確認順を説明しています。
症状によって、どこを調べればよいですか?
記事の表では、重大なエラー・白い画面・500エラーは直前の変更と発生時刻を記録してPHPログやサーバーのエラーログを確認します。
CSSだけ反映されない場合はブラウザの開発者ツールでCSSの読み込み、セレクター、上書き、キャッシュを確認します。
ボタン・開閉・スライダーが動かない場合は、開発者ツールのConsoleとNetworkでJavaScriptエラーや読み込み失敗を確認します。
対象はPHP側のエラー調査です。
wp-config.phpを編集する前に、何をしますか?
先にバックアップと復元方法を確認し、編集前のwp-config.phpを手元に保存します。
記事では、このファイルにはデータベースの接続情報などが含まれるため、記事・掲示板・公開フォルダーへコピーを置かないよう案内しています。
管理画面にも入れない場合は、サーバー管理画面やSFTPから変更を戻せるか確認し、WordPress内の編集画面だけに頼らないでください。
ログを公開領域に置く場合は、どうしますか?
記事では、公開領域外へ保存できない場合は、サーバー側でログファイルの取得を拒否します。
Apache 2.4用の例をwp-content内の.htaccessに置き、既存ファイルを保存して同じ設定がないか確認してから追記します。
Nginxには適用できないため、ホストのアクセス制限機能を使います。
隔離したApache 2.4.69では、拒否設定がないと標準ログのURLが200で読め、設定を加えると403になりました。
設置後は認証していないGET要求でログURLを確認し、本文を取得できないことを確かめます。
ログは、どう読みますか?
発生したページ・操作・時刻と、直前に変更したテーマやプラグインを記録します。
検証環境で同じ操作を1回行い、ログの更新日時を確認し、時刻が近い行から、エラー種別・メッセージ・ファイル名・行番号を読みます。
記事では、ログに出たファイル名だけで原因を断定せず、呼び出し元や入力値も調べるとしています。
Fatal errorは処理停止につながるエラー、Warningは警告、Deprecatedは非推奨機能の通知です。
debug.logが作られない、または更新されないときは?
記事では、キャッシュ済み画面を表示しただけではPHP処理が実行されない場合があるため、再現操作の確認が必要です。
ログはSFTPやサーバー管理画面から取得し、公開URLを調査用の共有先にしないでください。
保存先の親ディレクトリが自動作成されないことも確認されています。
確認できない場合は契約サーバーへ確認します。
調査が終わったあとは、どうしますか? 動作確認の範囲は?
記事の見出しでは、調査後は設定を戻し、古いログも整理します。
動作確認は2026年10月3日、隔離環境のPHP 8.2.29でWordPress 7.1.2のログ初期化処理と掲載の定数設定を実行したもので、本番設定やプラグイン固有のログ出力は変更・検証していません。
WordPressやサーバーの仕様は変わる可能性があるため、最新は公式で確認してください。



