Docker で nginx + PHP-FPM コンテナを作る方法

nginx の設定を変更したい場合は、nginx の設定ファイルを使用すると良いでしょう。

nginx の設定ファイルの詳しい書き方はここでは記載しませんが、 基本的な書き方としては {} で囲ってブロックになること、 終端には ; が必要になること、 # で1行コメントになることを覚えておくと良いでしょう。

nginx の設定ファイルの場所は "/etc/nginx" ディレクトリの配下です。 nginx の設定ファイルは複数のファイルで構成されています。 全体の設定は "/etc/nginx/nginx.conf" ファイルで、 そこからサーバーの設定として "/etc/nginx/conf.d" ディレクトリ配下の ".conf" ファイルが読み込まれるようになっています。

nginx の全体の設定である "/etc/nginx/nginx.conf" の方には大事な設定が書かれているので、変更する際は注意が必要です。 基本的にはサーバーの設定の方を変更する機会が多いと思いますので、そちらのファイルを変更しましょう。 デフォルトのサーバーの設定のファイルは "/etc/nginx/conf.d/default.conf" です。

（省略）

events {
    （省略）
}

http {
    （省略）

    include /etc/nginx/conf.d/*.conf;
}

server {
    listen 80;

    （省略）
}

デフォルトのサーバーの設定のファイルを変更してドキュメントルートを変更してみましょう。 ドキュメントルートを変更するには root を使用します。

server {

    # ドキュメントルート
    root /path/to/new/root;
}

version: "3.8"
services:

  # nginx コンテナ
  nginx:
    image: nginx:latest
    ports:
      - 8080:80
    volumes:
      - ./default.conf:/etc/nginx/conf.d/default.conf
      - ./html:/path/to/new/root

FROM nginx:latest

# nginx のデフォルトのサーバーの設定ファイルを配置
COPY ./default.conf /etc/nginx/conf.d/default.conf
RUN chmod 644 /etc/nginx/conf.d/default.conf

version: "3.8"
services:

  # nginx コンテナ
  nginx:
    build: ./nginx-custom
    ports:
      - 8080:80
    volumes:
      - ./html:/path/to/new/root

nginx のサーバーの設定ファイルを下記のように書き換えます。

location で、どの URL に対する設定なのかを指定できます。 指定する URL は、デフォルトでは前方一致での指定になるですが、~ を使用すると正規表現で指定することができます。

$document_root や $fastcgi_script_name など、$ から始まっているものは変数です。 例えば $document_root には、root で指定したドキュメントルートの値が入っています。

FastCGI を使用して接続する接続先の情報は fastcgi_pass で指定します。 TCP ポートを使用する方法と、Unix ソケットを使用する方法があるのですが、ここでは TCP ポートを使用する方法を説明します。 ホスト名として docker-compose.yml で定義しているサービス名（つまり、services 項目で指定しているキー）を使用できます。 上記の例では、ホスト名として "php-fpm" が使用できます。 PHP-FPM コンテナがリクエストを待ち受けているポート番号は 9000 番ですので、ポート番号には 9000 番を指定します。

fastcgi_param で PHP-FPM コンテナに渡すパラメーターを指定します。 デフォルトのパラメーターは "/etc/nginx/fastcgi_params" ファイルに用意されていますので、include で読み込んで使用します。

PHP-FPM コンテナで実行する PHP ファイルの名前は、SCRIPT_FILENAME パラメーターで指定します。 なお、実行する PHP ファイルは、PHP-FPM コンテナに置いておく必要があるので注意してください。

server {

    # ドキュメントルート
    root /usr/share/nginx/html;

    # 全ての PHP ファイル
    location ~ \.php$ {

        # PHP ファイルが nginx コンテナに存在しない場合は、
        # PHP-FPM コンテナに転送せずに 404 Not Found にする
        if (!-f $document_root$fastcgi_script_name) {
            return 404;
        }

        # FastCGI で PHP-FPM コンテナへ転送
        fastcgi_pass php-fpm:9000;

        # デフォルトの FastCGI パラメーター
        include fastcgi_params;

        # PHP-FPM コンテナで実行する PHP ファイルの名前
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

PHP のフレームワークでは、全てのリクエストを "/index.php" で処理するというフロントコントローラーパターンを使用しているものが多いです。 Apache を使用している場合は、mod_rewrite モジュールの RewriteRule を使用して URL を "/index.php" に書き換えていたと思います。

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

これと同じことを nginx でもできるように設定ファイルを変更してみましょう。

なお、nginx の設定ファイルはかなり自由度が高く、いろいろな書き方ができます。 下記の記述はほんの一例にすぎませんので、ご自身の環境に合わせて設定してください。

try_files を使用すると、ファイルが存在しているかどうかを確認することができます。

server {

    # ドキュメントルート
    root /usr/share/nginx/html;

    # 全てのリクエスト
    location / {

        # リクエストされたファイルが存在しなければ、
        # フロントコントローラーに内部リダイレクト
        try_files $uri /index.php?$query_string;
    }

    # 全ての PHP ファイル
    location ~ \.php$ {

        # nginx コンテナで PHP ファイルの存在確認はしない
        # 全てフロントコントローラーにまかせる

        # FastCGI で PHP-FPM コンテナへ転送
        fastcgi_pass php-fpm:9000;

        # デフォルトの FastCGI パラメーター
        include fastcgi_params;

        # PHP-FPM コンテナで実行する PHP ファイルの名前
        # - 全てのリクエストをフロントコントローラーで実行
        fastcgi_param SCRIPT_FILENAME $document_root/index.php;
    }
}

まずはデフォルトのサイト設定が邪魔にならないよう無効化しておきましょう。 無効化しなくても良いと言えば良いのですが、バーチャルホストを使って複数サイトを管理するならおそらく使用しないと思います。

デフォルトのサーバーの設定のファイルは "/etc/nginx/conf.d/default.conf" ですので、そのファイルを読み込まないようにします。 削除するのもあれなので、念のためにファイル名を変更して置いておくことにします。 設定ファイルとして読み込まれるのは拡張子が ".conf" のファイルだけなので、拡張子 ".bak" を付けて無効化します。

FROM nginx:latest

# デフォルトのサイト設定を無効化
RUN mv /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.bak

次にバーチャルホストを使用したい各サイトの設定ファイルを追加します。

nginx の設定ファイルは最初からバーチャルホストに対応しています。 各サイトの設定ファイルを "/etc/nginx/conf.d" ディレクトリの配下に置くだけです。 設定ファイルの server ブロックが1つのサーバー（つまりホスト）の扱いなので、 1つのファイルに複数の設定を記述することもできるのですが、ファイルは分けておいた方が良いでしょう。 ホスト名は server_name で指定できます。

サイトの設定ファイルはアルファベット順に読み込まれます。 優先順位を付けたい場合は、ファイルの名前の先頭に番号を付けておくと良いでしょう。 どのサイトのホスト名にも一致しない URL が指定された場合、最初に読み込まれた設定ファイルのサイトが表示されます。

server {

    # ホスト名
    server_name site1.localhost;

    # ドキュメントルート
    root /path/to/site1/root;
}

server {

    # ホスト名
    server_name site2.localhost;

    # ドキュメントルート
    root /path/to/site2/root;
}

FROM nginx:latest

# デフォルトのサイト設定を無効化
RUN mv /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.bak

# サイト1の設定を追加
COPY ./001-site1.conf /etc/nginx/conf.d/001-site1.conf
RUN chmod 644 /etc/nginx/conf.d/001-site1.conf

# サイト2の設定を追加
COPY ./002-site2.conf /etc/nginx/conf.d/002-site2.conf
RUN chmod 644 /etc/nginx/conf.d/002-site2.conf

最後に各サイトのドキュメントルートにバインドマウントして、表示したいファイルを配置します。

version: "3.8"
services:

  # nginx コンテナ
  nginx:
    build: ./nginx-custom
    ports:
      - 8080:80
    volumes:
      - ./site1_html:/path/to/site1/root
      - ./site2_html:/path/to/site2/root