はじめに
ここでは、なぜWordPressのページが突然真っ白な画面になりHTMLが出力されないのか、その原因と対策について詳しく説明します。この問題はしばしばPHPエラーによって引き起こされるため、適切なエラーロギングや設定変更が必要となります。
症状・背景
このテーマが必要になる主な場面:
- PHPのバージョンを更新した後に発生
- テーマまたはプラグインに問題がある場合
- WordPressデータベースが壊れている場合
- .htaccessファイルにエラーがある場合
手順・設定方法
ステップ1: デバッグモードを有効にする
# WordPressのデバッグモードをオンにします。
define('WP_DEBUG', true);
# ファイルまたは行番号情報を含むエラー出力を有効化します。
define('WP_DEBUG_DISPLAY', true);ステップ2: エラーログを作成する
# WordPressのエラーログファイルへの書き込みを許可します。
define('WP_DEBUG_LOG', true);
# デフォルトでは/wp-content/debug.logにエラーが記録されます。ステップ3: .htaccessファイルを確認・修正する
# Apacheの.htaccessファイルの例です。適切な設定が含まれていることを確認します。
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>ステップ4: ファイルとディレクトリの権限を確認する
# WordPressファイルおよびディレクトリの所有者を設定します。
chown -R www-data:www-data /path/to/wordpress
# .htaccessやwp-config.phpのようなファイルの書き込み権限を制御します。
chmod 644 wp-config.php
# フォルダに読み取り、書き込み、実行権限を与える
chmod 755 wp-content注意事項
- エラーロギングはサーバーのパフォーマンスに影響を及ぼす可能性があるため、必要になったらのみ有効化するべきです。
- .htaccessファイルはホストによって異なる場合がありますので、ご自身の環境で確認してください。
- ファイルやディレクトリの権限設定は、サーバーとOSにより異なります。
まとめ
1. デバッグモードをオンにする: PHPエラーを表示するためにはデバッグモードが必要です。
2. エラーロギングを有効化: エラー情報を記録し、問題解決に役立ちます。
3. htaccessファイルの確認と修正: 正しい設定が含まれていることを確認します。
4. 権限設定の確認: ファイルやディレクトリに対する適切なアクセス権を確保します。
関連記事: