🙌

Ubuntu24.04 + PHP8.3 + Certbotで詰まった実装ログ~Nginx × WordPress構成の注意点~

に公開

この記事について

この記事は、GCP Always Free 環境で WordPress を構築する過程で、実装段階に入ってから実際に詰まった点をまとめたログです。Part1では「先にやらないと詰む初期前提」を扱いました。

今回はその続きとして、

  • Ubuntu 24.04
  • PHP 8.3
  • Certbot(Let’s Encrypt)

といった バージョン・実装依存の問題に焦点を当てます。

前提構成(再掲)

  • GCP Compute Engine(e2-micro)
  • Ubuntu 24.04 LTS
  • Nginx
  • PHP 8.3(PHP-FPM)
  • WordPress

PHP-FPMのソケット不一致で502が出た話

Nginx設定は問題なさそう。WordPressのファイルも正しく配置されている。それでも表示されない。エラーログを見ると、典型的な 502 Bad Gateway。原因は単純で、PHP-FPMのソケット指定がズレていました。

fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;

Ubuntu 24.04 では PHP 8.3 が入ります。古い記事を参考にしていると、php8.1-fpm.sock や php-fpm.sock を指定してしまいがちです。

学び

  • PHP-FPMは「動いているが繋がっていない」状態が起きやすい

  • 502が出たら、まずソケットを疑う

php.ini の場所が違っていた

次に詰まったのが、php.ini の場所が見つからない問題です。古い情報では /etc/php/8.x/apache2/php.ini が出てきますが、Nginx + PHP-FPM 構成では参照先が異なります。

/etc/php/8.3/fpm/php.ini

設定を変えたつもりでも反映されない場合、そもそも編集しているファイルが違うケースがありました。

Certbot導入時の前提条件にハマる

独自ドメインを設定し、CertbotでSSL化しようとした段階で、再び詰まりました。

server_name が _ のままだった

初期構築時は以下のようにしていました。

server_name _;

この状態では、Certbotはどのドメインの証明書を取ればいいか判断できません。

server_name example.com;

ドメインを明示的に指定する必要があります。

80番ポートが開いていなかった

さらに、GCP側のファイアウォールで80番が未許可でした。CertbotはHTTP通信で到達確認を行うため、ここが閉じていると証明書取得に失敗します。NginxやCertbot以前の問題でした。

なぜこの辺りが見落とされやすいのか

  • 初期構築段階では問題なく動く

  • 記事どおり進めても突然エラーが出る

  • 原因が「設定漏れ」「前提条件」にある

という点で、切り分けが非常に難しいポイントでした。

まとめ

  • 502が出たら PHP-FPM ソケットを確認

  • php.ini は FPM 用を編集しているか確認

  • Certbot前に server_name と 80番開放をチェック

Part1で扱った「初期前提」と合わせて、この2本で GCP × Nginx × WordPress 構築時の地雷は一通り踏んだと思います。

Discussion