WordPressのデバッグログを有効にする前に確認することは、エラーを公開画面へ表示しない設定になっているかです。調査中に `WP_DEBUG` を使うことはありますが、本番サイトでエラー内容を画面に出すと、ファイルパスやプラグイン名などの内部情報が見える可能性があります。
原因を調べたいときは、ログへ記録し、画面表示は止める方が安全です。`wp-config.php` を編集する前に、バックアップ、編集場所、戻し方を確認してから作業します。
最初の結論：本番では画面表示を止め、ログだけ残す
WordPressのデバッグログを有効にする目的は、エラーを読者に見せることではなく、管理者が原因を調べることです。WordPress公式のデバッグ資料では、
WP_DEBUG_LOG
でログを保存でき、
WP_DEBUG_DISPLAY
を false にすると画面表示を止められると説明されています。
公開サイトで画面にPHPエラーを出すと、ファイルパス、テーマ名、プラグイン名、サーバー構成の一部が見えることがあります。読者にとっても「このサイトは壊れている」と感じる表示になります。調査中でも、公開画面では非表示、管理者だけがログを見る、という分け方が安全です。
設定値の意味を分けて理解する
| 設定 | 役割 | 本番での考え方 |
|---|---|---|
| WP_DEBUG | デバッグ機能の有効化 | 調査時だけ有効にする |
| WP_DEBUG_LOG | エラーをログへ保存 | 原因調査に使う |
| WP_DEBUG_DISPLAY | 画面へ表示するか | 本番では false が基本 |
| SCRIPT_DEBUG | 圧縮前スクリプト確認 | 通常は本番で使わない |
ログを見る前に準備するもの
wp-config.php
を編集する前に、ファイルのバックアップ、FTPやファイルマネージャーへの復旧手段、管理画面へ入れなくなった場合の戻し方を用意します。エラー調査中は、小さな記述ミスでサイト全体が真っ白になることがあります。
ログ確認では、最初に
Fatal error
、
Parse error
、
Allowed memory size
、
undefined function
、
deprecated
のような言葉を見ます。どのプラグインやテーマのパスに出ているかを見れば、停止すべき候補を絞れます。
調査後に必ず戻すこと
- 画面表示が止まっているか確認する
- ログファイルが外部から読めない場所にあるか確認する
- 原因プラグインやテーマを更新・停止・差し替えする
- 不要になったデバッグ設定を戻す
- 公開ページを再読み込みしてエラー表示が消えたか確認する
本番で避けたい設定
| 設定 | 意味 | 本番での注意 |
|---|---|---|
| WP_DEBUG true | デバッグ機能を有効にする | 調査中だけにする |
| WP_DEBUG_DISPLAY true | 画面へエラーを表示する | 訪問者に内部情報が見えるため避ける |
| WP_DEBUG_LOG true | ログファイルへ記録する | 確認後に不要なログを放置しない |
| display_errors | PHP側の画面表示 | サーバー設定で有効になっていないか確認する |
安全に調査する順番
- サーバーまたはCMSのバックアップを確認する
- wp-config.phpを編集できる手段を確認する
- 画面表示ではなくログ記録で調査する
- エラー発生操作を1つだけ再現する
- debug.logを確認し、プラグイン名やテーマ名を特定する
- 調査後は設定を戻し、ログファイルを放置しない
ログを見るときは、最後の数十行だけを確認します。古いエラーが大量に残っていると、今回の原因と関係ない情報に引っ張られます。エラーを再現した時刻とログの時刻を合わせると、原因に近づきやすくなります。
ログって、全部読まないといけないと思ってました。
最後の方だけでいいんですね。
今回起きたエラーを見たいから、時刻が大事だね。
古いログまで追うと迷子になりやすい。
たしかに、知らない英語がいっぱい出たら泣きそうです…。
全部理解しようとしなくて大丈夫。
まずはプラグイン名、テーマ名、ファイル名、時刻を見るだけでも前に進めるよ。
ログで見るべき言葉
初心者が最初に見るべきなのは、`Fatal error`、`Parse error`、`Allowed memory size`、プラグインやテーマのフォルダ名です。Fatal errorは処理が止まる重大なエラー、Parse errorはコードの書き方の問題、memory sizeはPHPメモリ不足の可能性があります。エラー文を公開フォーラムへ貼る場合は、ドメイン名、ユーザー名、絶対パスなどを伏せます。
よくある質問
WP_DEBUGを常時オンにしてもいいですか？
本番サイトではおすすめしません。調査時だけ使い、終わったら戻します。
debug.logはどこにできますか？
一般的には `wp-content/debug.log` に出ますが、サーバーや設定で変わることがあります。
ログを見ても原因が分からない場合は？
エラー時刻、プラグイン名、直前に更新したものを整理し、プラグイン停止やテーマ切り替えを慎重に試します。
デバッグは画面ではなくログで確認する
エラー調査では、公開画面に内部情報を出さないことが大切です。ログ記録、再現操作、時刻確認、設定を戻すところまでを1セットにしてください。