技術メモ 読む時間 約2分

WordPressでエラーログをファイルに保存(debug.log)

WordPressでエラーログをファイルに保存(debug.log)

初期状態ではログを出すようになっていない

エラーなど調査を行いたい時に設定すると便利です。使い終わったら設定をオフに戻しましょう。戻さないと、ログファイルが大きくなり続けます。

ログファイルに出す設定

wp-config.php の「/* 編集が必要なのはここまでです */」という行より上に、次の 3 行を追加します。

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );
define( ‘WP_DEBUG_LOG’, true );

画面にはエラーを表示せず、debug.log にエラーや警告を書き出すようになります。

ログファイルの確認

wp-content/debug.log にファイルが作成されるのでこちらの内容を確認します。

注意:wp-content/debug.log は、そのままでは URL で外から読めてしまいます。ログにはサーバーのパスなどが書かれるので、調べ終わったら WP_DEBUG を false に戻し、debug.log を削除してください。使っている間は、.htaccess で debug.log へのアクセスを禁止しておくと安心です。

<Files “debug.log”>
  Require all denied
</Files>

WP_DEBUG_LOG に true のかわりにファイルのパスを書くと、保存する場所を変えられます(WordPress 5.1 以降)

define( ‘WP_DEBUG_LOG’, WP_CONTENT_DIR . ‘/logs/debug.log’ );

保存先のフォルダ(この例では wp-content/logs)は、先に作っておきます。公開のフォルダの外に置くと、URL で読まれる心配がなくなります。

この記事を書いた人

フリースタイル

Web の仕事 25 年以上。WordPress の保守・引っ越しと、PHP の業務の仕組みづくり。 プロフィール →

まずは、お気軽にご相談ください。

相談と見積りは無料です。急ぎのときは、フォームで「急ぎ」を選んでください。