WordPressページにエラーを表示させずdebug.logにログを出力 ダッシュボードでエラー確認が行えるようにする方法

WordPress 6.4.3
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

概要説明

WordPressのエラーログを画面に表示させずdebug.logに表示させる設定例。 debug.logに直接アクセスされた時用の対策も掲載しています。定期的にアクセスログの確認、対応しておくことで今後のバージョンアップなどでのエラー、トラブルを防止することができます。

画面にエラーを表示させずdebug.logにログを出力させる設定

wp-config.php
define('WP_DEBUG', true); // デバッグ機能 有効
define('WP_DEBUG_LOG', true); // ログ出力 有効
define('WP_DEBUG_DISPLAY', false); // デバッグ情報の画面表示 無効

この設定で、/wp-content/debug.log にログが書き出されます。

ログファイルのパス、ファイル名を変更したい場合

wp-config.php
// ログのパス・ファイル名を変える(WordPress 5.1 から)
// 枠 1 の define('WP_DEBUG_LOG', true); の行を、この 1 行に書き換える(同じ定数を 2 回書かない)
// wp-config.php の中では WP_CONTENT_DIR はまだ決まっていないので __DIR__ で書く
// logs のフォルダは先に作り、PHP が書き込めるようにしておく
define( 'WP_DEBUG_LOG', __DIR__ . '/wp-content/logs/error.log' );

ini_set( 'error_log', … ) を wp-config.php に書いても、WP_DEBUG_LOG が true のときは、WordPress が wp-content/debug.log で上書きします。パスを変えるときは、WP_DEBUG_LOG にパスの文字列を渡します。wp-config.php の中では WP_CONTENT_DIR はまだ決まっていないので、__DIR__ で書きます(WP_CONTENT_DIR と書くと、PHP 8 では Fatal error でサイトが止まります)。公開のフォルダの外(例:dirname( __DIR__ ) . '/logs/wp-error.log')に置くと、より安全です。

debug.log をブラウザからアクセス禁止にする

https://xxxxxx.net/wp-content/debug.log

制限しないと、だれでもログファイルを見られるので、アクセスを止めます。

.htaccess にて debug.log のアクセス制限

.htaccess
# debug.log と、パスを変えたときの error.log をブラウザから見られないようにする
<FilesMatch "^(debug|error)\.log$">
<IfModule mod_authz_core.c>
Require all denied
</IfModule>
<IfModule !mod_authz_core.c>
Order allow,deny
Deny from all
</IfModule>
</FilesMatch>

 

WordPressページにエラーを表示させずdebug.logにログを出力 ダッシュボードでエラー確認が行えるようにする方法

Error Log Monitor プラグインを導入してダッシュボードからエラー確認

直近のエラーの表示、debug.log の初期化などがダッシュボードで行えるようになります

WordPressページにエラーを表示させずdebug.logにログを出力 ダッシュボードでエラー確認が行えるようにする方法

対応が終わったらもとに戻しておきましょう

debug.log に書き出したままにして、ログファイルがかなり大きくなっているサイトを、ときどき見かけます。

wp-config.php
define( 'WP_DEBUG', false );

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。