はじめに
WordPressサイトの管理や保守において、プラグインによる問題が発生することはよくあります。その中でも特に深刻な状況として「白い画面」（White Screen of Death, WSOD）があります。これは通常、PHPエラーやサーバー設定の問題、もしくは特定のプラグインと関連していることが多いです。
この記事では、WSODが発生した場合にどのプラグインが原因となっているのかを特定する方法について解説します。これにより、迅速に対処し、サイトの正常な動作を回復することができます。
症状・背景
このテーマが必要になる主な場面:
- ホームページや管理画面を開こうとした際に白い画面が表示される
- 特定のページにアクセスしようとしたときにWSODが出る
- 新しいプラグインを追加した直後に問題が発生する
- 既存のプラグインを更新した後、サイト全体または特定の機能が停止する
手順・設定方法
ステップ1: デバッグモードを有効にする
# wp-config.phpファイルを開き、次の行を見つけます。この行がない場合は追加します。
define('WP_DEBUG', true);
# さらに以下の行も追加して、エラー情報をログに保存するように設定します。
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);ステップ2: プラグインの無効化
# FTPクライアントまたはSSHを使用してwp-content/pluginsディレクトリへアクセスします。
cd wp-content/plugins/
# 各プラグインを順に無効化していきましょう。以下は単一のプラグイン（example-plugin）を無効にする方法です。
mv example-plugin example-plugin-disabledステップ3: プラグインの組み合わせとテスト
# 一つずつ有効化していき、問題が発生するか確認します。エラーがない場合、そのプラグインをwp-content/pluginsディレクトリに元に戻し、次のプラグインへ移ります。
mv example-plugin-disabled example-plugin
# 上記の手順で特定した原因となるプラグインがある場合は、そのプラグインを削除または無効化します。ステップ4: 実践/トラブルシューティング/監視
# 発生している問題が特定できたら、wp-content/debug.logファイルを開き、詳細なエラーログを確認します。このログには発生したエラーの種類やその原因について詳しく記録されています。
tail -f /path/to/your/site/wp-content/debug.log注意事項
- デバッグモードを公開サイトで長期間使用すると、情報を漏洩する可能性がありますので注意してください。
- プラグインの無効化や削除を行う際にはバックアップを取り、問題が発生した場合に備えましょう。
- セキュリティ上の観点から、プラグインの更新は常に最新版を確認し、利用するようにします。
- パフォーマンス向上のため、不要なプラグインは削除または無効化することをお勧めします。
まとめ
1. デバッグモード有効: エラー情報の収集と問題特定に役立ちます
2. プラグイン無効化: 問題を引き起こす可能性があるプラグインを一時的に無効化します
3. ログ確認: 発生したエラー情報を理解するため、debug.logファイルから詳細な情報を見つけてください
4. 保守管理: プラグインの更新や無効化を定期的に行い、セキュリティとパフォーマンスを保ちましょう
5. バックアップ: 無効化または削除したプラグインは、必要であれば復元できるようにバックアップを取ります
関連記事: