Dockerはいいぞ – docker-compose 実践編

# ./docker-compose.yml
services:
  php:
    image: php:8.2-fpm
    volumes:
      - ./src:/var/www/app
  nginx:
    build:
      context: .
      dockerfile: docker/nginx/Dockerfile
    volumes:
      - ./src:/var/www/app
    ports:
      - ${APP_PORT:-80}:80

実にシンプルですね。nginxとphpという2つのコンテナを作成するための設定です。用語や詳しい概念については検索していただければわかりやすい記事が無数にありますので省略します。あまり理解していなくてもなんとなく使えるのがDockerの良いところです。

phpコンテナの方ですがDocker公式のリポジトリからphp:8.2-fpmというイメージを持ってきてそのまま使用しています。誰かが用意してくれたイメージがあれば何の設定もなく簡単に使い回せるということです。非常にお手軽です。volumesの./src:/var/www/appについては、docker-compose.ymlファイルを配置しているディレクトリにsrcというディレクトリがあればphpコンテナ上の/var/www/appに同期する設定です。nginxの設定ファイルの方で説明しますがsrcに.phpファイルを配置しておけばブラウザから実行できるようになります。

nginxコンテナの方は別途./docker/nginx/Dockerfileという設定ファイルを用意して独自のイメージをビルドします。buildのcontextは相対パスの開始ディレクトリを設定します。

context: ./docker/nginx
dockerfile: Dockerfile

のように書くこともできますが、Dockerfileで./docker/nginxより上の階層を参照できないので私は作業ルートを設定するのが好みです。詳しくは以下を参考にしてください…

docker-compose.ymlのbuild設定はとりあえずcontextもdockerfileも埋めとけって話

portsはホストのポート:コンテナのポートを対応付ける設定です。ホスト側のポートは任意のポートでOKです。上記の例では.envファイル等でAPP_PORTの環境変数を設定していればその値を使い、なければ80をデフォルト値として使うという設定になっています。これでlocalhost:80へのアクセスがnginxコンテナのポート80にポートフォワードされるようになりました。

# ./docker/nginx/Dockerfile
FROM nginx:latest

COPY ./docker/nginx/default.conf /etc/nginx/conf.d/default.conf

驚きのシンプルさです。公式のnginxイメージを使いホスト側の./docker/nginx/default.confファイルをnginxコンテナの/etc/nginx/conf.d/default.confにコピーしているだけです。特に説明することもないので次に進みます。

server {
    listen 80;
    server_name localhost 127.0.0.1 0.0.0.0;
    root /var/www/app;

    index index.php index.html index.htm;

    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /$1.php;
        }
    }

    location ~ \.php$ {
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

これもそこまで複雑な設定ではないのではないでしょうか。server_nameで設定されたサーバー名のポート80でリクエストを受けたらこの設定が使用されます。rootで設定しているのはdocker-compose.ymlのvolumesで設定しているものと同じです。location ~ .php$ 以下で./srcに配置したphpファイルがあればfastcgi_passでphpコンテナのポート9000にリクエストを投げて処理を任せます。（この設定では.phpファイル以外のファイルはnginxコンテナだけで処理されます。）

真ん中のrewriteについてですが、例えば/hogeでアクセスがあったときに/var/www/app/hogeというファイルが存在しなければ/var/www/app/hoge.phpファイルを探します。必須ではないですが/var/www/app/hello-world.phpファイルを実行したいと思ったら/hello-worldでアクセスできるようになるのでブラウザでの確認がほんの少し捗ります。

<?php
echo "Hello, World!";

ブラウザからlocalhostにアクセスしてHello, World!の文字列が表示されていれば成功です。もうひとつ、.phpの拡張子なしでも表示できることを確認します。./src/phpinfo.phpを以下の内容で作成しましょう。

<?php
phpinfo();

ブラウザからlocalhost/phpinfoにアクセスして以下のような画面が表示されれば成功です。