はじめに
WordPressサイトを運用する上で、予期しないエラーが発生することがあります。これらのエラーは単純な設定ミスから重大なセキュリティ問題まで多岐にわたります。そのため、問題の原因を迅速かつ正確に特定し解決することは非常に重要です。この記事では、WordPressサイトでデバッグ情報を記録するためのロギング方法について詳しく解説します。
症状・背景
- サイトが表示されない（白い画面）
- 特定の機能が正常に動作しない
- PHPエラーが発生している可能性がある
- セキュリティ上の問題を調査する必要がある
手順・設定方法
ステップ1: WP_DEBUGモードの有効化
# wp-config.phpファイルを開く（エディタを使用）
nano /var/www/html/wp-config.php
# 'define('WP_DEBUG', false);'を'define('WP_DEBUG', true);'に変更するステップ2: WP_DEBUG_LOGとWP_DEBUG_DISPLAYの設定
# wp-config.phpファイルを開き、以下の行を追加または修正します
nano /var/www/html/wp-config.php
# ログ出力を有効にする
define('WP_DEBUG_LOG', true);
# ブラウザでの表示をオフに（セキュリティの観点から）
define('WP_DEBUG_DISPLAY', false);ステップ3: WP_CONTENT_DIRとLOG_PATHの設定
# wp-config.phpファイルを開き、以下の行を追加または修正します
nano /var/www/html/wp-config.php
# ログファイルの保存ディレクトリを指定
define('WP_CONTENT_DIR', '/path/to/your/content-directory');
define('WP_LOG_DIR', WP_CONTENT_DIR . '/logs');
# 必要に応じてログファイルのパーミッションを設定
chmod 755 /path/to/your/content-directory/logsステップ4: ロギングの監視とトラブルシューティング
# ログファイルを開き、エラー情報を確認する
tail -f /path/to/your/content-directory/logs/debug.log注意事項
- WP_DEBUGをオンにすると、サイトのパフォーマンスが低下することがあります。
- デバッグ情報をログに出力した場合、セキュリティ上のリスクが生じる可能性がありますので注意が必要です。
- ログファイルは定期的に削除または圧縮して保存ディレクトリを整理するようにしましょう。
まとめ
1. WP_DEBUG: サイトで発生している問題を詳細に調査するために有効にする重要な設定です。
2. WP_DEBUG_LOG: ブラウザではなく、サーバー上のファイルシステムにログ情報を記録します。
3. WP_LOG_DIR: ログファイルが保存されるディレクトリをカスタマイズすることで、セキュリティや管理の観点から適切な場所を選択できます。
4. ログ監視: 定期的にログファイルをチェックし、問題を早期に発見します。
5. 安全な運用: デバッグ情報を記録する際は、セキュリティ上のリスクを考慮して適切な設定を行いましょう。
関連記事: