はじめに
WordPressサイトでエラーが発生した場合、正確な原因を特定することが重要です。デバッグモードは、開発者が問題の解決に必要な情報を提供します。
症状・背景
このテーマが必要になる主な場面:
- ページが白い画面（White Screen of Death）になる
- WordPressの管理画面でエラーが表示される
- 更新やインストール時にエラーメッセージが表示される
- サイトの動作に遅延がある
手順・設定方法
ステップ1: デバッグモードの有効化
# wp-config.phpファイルを開く
nano /var/www/html/wp-config.php
# 下記の行を追加または変更
define('WP_DEBUG', true);
# 保存して閉じる
CTRL + X, Y, Enterステップ2: デバッグログの出力設定
# wp-config.phpファイルを開く
nano /var/www/html/wp-config.php
# 下記の行を追加または変更
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
# 保存して閉じる
CTRL + X, Y, Enterステップ3: フォルダ権限の設定
# wp-contentディレクトリにwp_debug.logを作成するための権限を変更
chown -R www-data:www-data /var/www/html/wp-content/
# サブフォルダーにも権限を適用
chmod -R 755 /var/www/html/wp-content/ステップ4: ログファイルの確認
# wp-content/debug.logを開く
tail -f /var/www/html/wp-content/debug.log注意事項
- <実践的な注意点1>: デバッグモードは開発環境やテストサイトで使用し、公開サイトでは無効にすること。
- <実践的な注意点2>: ログファイルのサイズが大きくなりすぎないように定期的にクリーンアップすること。
- <セキュリティ上の注意>: デバッグ情報を含むログファイルは外部へ漏洩しないように適切なアクセス制御を行うこと。
- <パフォーマンス/運用上の注意>: デバッグモードの有効化がパフォーマンスに影響を与える可能性があるため、必要最小限の期間で使用すること。
まとめ
1. デバッグ情報の取得: WP_DEBUGをtrueに設定することで、WordPressから詳細なエラーメッセージを得られます。
2. ログ出力の制御: WP_DEBUG_LOGとWP_DEBUG_DISPLAYを使用してログファイルへの記録や表示を制御できます。
3. 権限管理: wp-contentディレクトリの適切な権限設定は、デバッグ情報を取得するための重要なステップです。
4. 定期的な保守: デバッグ情報はセキュリティリスクになり得るため、定期的にファイルを削除またはクリーンアップすることをお勧めします。
5. 公開サイトへの影響: デバッグモードは開発やテスト環境で使用し、公開サイトでは無効にすることが重要です。
関連記事: