2026年9月19日

WordPressのFastCGIエラーを解決する方法

エラー・白い画面

はじめに

FastCGIエラーは、ウェブサーバーとPHPスクリプト間の通信がうまくいかないときに発生します。特にApacheやNginxを運用している場合、この問題に直面することがあります。この記事では、WordPressサイトで遭遇する可能性のある主要な原因と解決策について詳しく説明します。

症状・背景

<ブラウザのURLバーに「502 Bad Gateway」や「500 Internal Server Error」といったエラーメッセージが表示される>
<ウェブページが完全に白い状態で表示される>

手順・設定方法

ステップ1: Apacheの設定ファイルを確認する

# WordPressサイトのドキュメントルートに移動します
cd /var/www/html/your-wordpress-site/

# デフォルトのApache設定ファイルを開きます（必要に応じてカスタム設定ファイルを使用）
sudo nano /etc/apache2/sites-available/000-default.conf

# FastCGI対応のPHPスクリプトを実行するためのFastCgiModuleが有効であることを確認します
<IfModule mod_fastcgi.c>
    AddHandler php5-fcgi .php
    Action php5-fcgi /fcgi-bin/php.fcgi
</IfModule>

# 必要に応じて、PHP-FPMへのパスを設定します
ScriptAlias /fcgi-bin/ "/usr/lib/cgi-bin/"

ステップ2: Nginxの設定ファイルを確認する

# WordPressサイトのNginx設定ファイルを開きます
sudo nano /etc/nginx/sites-available/default

# FastCGI対応のPHPスクリプト実行用の設定を追加します
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 使用しているPHPバージョンに合わせて修正が必要です。
}

# PHP-FPMへのパスが適切であることを確認します
fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;

ステップ3: PHP-FPMの設定を調整する

# PHP-FPMの設定ファイルを開きます
sudo nano /etc/php/7.4/fpm/pool.d/www.conf # 使用しているPHPバージョンに合わせて修正が必要です。

# 開発者モードを有効にしてデバッグ情報を取得します
php_admin_value[error_log] = /var/log/php_errors.log
php_flag[display_errors] = on
php_admin_value[error_reporting] = E_ALL

# 必要な場合、プロセスの数やタイムアウト時間を調整します
pm.max_children = 50
pm.process_idle_timeout = 10s; # タイムアウト時間はサーバー環境に応じて変更が必要です。

ステップ4: 変更を反映させます

# ApacheやNginxの設定が正しいことを確認します
sudo systemctl restart apache2
sudo systemctl restart nginx

# PHP-FPMも再起動して設定を適用します
sudo systemctl restart php7.4-fpm # 使用しているPHPバージョンに合わせて修正が必要です。

注意事項

<サーバーのロードやリソース使用状況を定期的にチェックし、必要に応じて調整を行う>
<セキュリティ上の脆弱性がないか定期的にスキャンを行い、更新やパッチ適用を行う>
<バックアップを定期的に行い、重要なデータの喪失を防ぐ>

まとめ

1. : ファストCGIモジュールとPHP-FPMへのパスを正しく設定することが重要です。

2. : FastCGI対応のPHPスクリプト実行用のlocationブロックを適切に配置します。

3. : プロセス数やタイムアウト時間を最適化して、サーバーロードを安定させることが効果的です。

4. <再起動と確認>: 変更後の設定が正しく反映されているか確認するために、ウェブサーバーの再起動が必要です。

5. <定期メンテナンス>: パフォーマンスやセキュリティを維持するためには、定期的なメンテナンスとモニタリングが不可欠です。

Post Views: 17