はじめに
前回は「Docker Compose設計の基本」として、dev/prodを分けて破綻を防ぐ考え方を整理しました。
今回は一気に実践編です。
業務でDockerを使う場面で、最も出番が多い構成のひとつが「Web+DB」です。
たとえば、PHPアプリケーションであれば次の組み合わせが典型です。
- Web:Nginx
- アプリ:PHP-FPM
- DB:MariaDB
この構成は、WordPressや社内ツール、業務システム、CRMなど、多くの現場で共通して登場します。
本記事では「とりあえず動く」ではなく、業務で運用できる最小構成として、Docker Composeの形を整理します。
第2回のゴール
今回のゴールは明確です。
次の状態になっていることを確認します。
- PHP+Nginx+MariaDBがDocker Composeで起動できる
- 設定ファイルの置き場が整理されている
- DBのデータが消えない(ボリュームで永続化されている)
- 「この構成をベースに案件で使える」と言える形になっている
なぜこの構成が実務で強いのか
PHPの実務環境というと、昔はApache(mod_php)が主流でした。
しかしDockerで運用する場合は、Nginx+PHP-FPMの構成が基本になります。
理由はシンプルで、役割分担が明確だからです。
- Nginx:HTTPを受ける(入口)
- PHP-FPM:PHPを実行する(アプリ処理)
- MariaDB:データを保存する(永続化)
この分離は、後々スケールや運用を考えるときにも効いてきます。
また、コンテナの設計としても自然で、チーム内で標準化しやすいのが強みです。
おすすめのディレクトリ構成
Docker Composeが破綻する典型パターンは、設定ファイルの置き場が決まっていないことです。
そこで、最初から「置き場の型」を決めておきます。
例として、次のような構成が扱いやすいです。
project/
docker/
nginx/
default.conf
php/
Dockerfile
php.ini
src/
(PHPアプリのソース)
docker-compose.yml
ポイントは、Docker関連のファイルをdocker/配下にまとめることです。
こうしておくと、プロジェクトが大きくなっても整理が崩れません。
業務で使えるdocker-compose.yml(最小構成)
ここでは「業務でよくある形」に寄せたCompose例を示します。
dev/prod分離は第1回で扱ったため、今回はまず共通部分を意識します。
version: "3.9"
services:
nginx:
image: nginx:1.25
ports:
- "8080:80"
volumes:
- ./src:/var/www/html
- ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
php:
build:
context: .
dockerfile: ./docker/php/Dockerfile
volumes:
- ./src:/var/www/html
db:
image: mariadb:11
environment:
MYSQL_ROOT_PASSWORD: rootpass
MYSQL_DATABASE: appdb
MYSQL_USER: appuser
MYSQL_PASSWORD: apppass
volumes:
- db_data:/var/lib/mysql
volumes:
db_data:
このComposeの狙いは、次の3点です。
- NginxとPHPを分離し、責務を明確にする
- DBは必ずボリュームで永続化する
- 「あとから拡張しやすい形」にする
Nginx設定(default.conf)の考え方
Nginxの設定は、最初からファイルとして分離しておくのが鉄則です。
docker-compose.ymlの中に書き始めると、必ず管理不能になります。
最小の例は次のようになります。
server {
listen 80;
server_name localhost;
root /var/www/html;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass php:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
ここで重要なのは、fastcgi_pass php:9000です。
これは「phpサービス(コンテナ)に処理を渡す」という意味になります。
Docker Composeでは、サービス名がそのまま名前解決されるため、ホスト名として使えます。
PHPコンテナはDockerfileで作るのが基本
PHPは「公式イメージをそのまま使う」だけでも動きます。
しかし業務では、たいてい追加の拡張モジュールが必要になります。
そのため、PHPはDockerfileで管理するのが基本です。
例えば、PHP8.2-FPMをベースにする場合は次のようになります。
FROM php:8.2-fpm
RUN apt-get update \
&& apt-get install -y \
libpng-dev \
libzip-dev \
libicu-dev \
libxml2-dev \
libonig-dev \
&& docker-php-ext-install \
pdo_mysql \
mbstring \
intl \
zip \
gd \
simplexml
入門段階で重要なのは「完璧なDockerfileを書くこと」ではありません。
業務で必要な拡張はDockerfileで管理するという考え方を理解することです。
DBは必ず永続化する(これが実務の最低ライン)
DockerでDBを扱うときに最も危険なのは、次の状況です。
「コンテナを消したらDBの中身も消えた」
開発段階では許されても、本番では絶対に許されません。
そのため、DBは必ずボリュームで永続化します。
今回のComposeでは、次の定義がそれにあたります。
- db_data:/var/lib/mysql
この1行があるだけで、コンテナを作り直してもデータが残ります。
これが業務利用の最低ラインです。
最初の起動と確認
ここまでの準備ができたら、起動はシンプルです。
docker compose up -d起動後は、次の観点で確認します。
- nginx, php, db の3つが起動している
- ブラウザで http://localhost:8080 が表示できる
- DBコンテナが落ちていない
もしうまくいかない場合は、まずログを見ます。
docker compose logs -f「動かないときはログを見る」
これがDocker運用の基本動作になります。
次回予告
次回(第3回)は、今回の構成をさらに実務寄りに整えるために、環境変数と設定管理(.env運用)を扱います。
- パスワードをdocker-compose.ymlに直書きしない
- .envファイルで設定を分離する
- 本番で「事故らない」管理方法
Docker Composeは、動くようになった後に「設定の持ち方」で差が出ます。
次回はそこを整理して、引き継げるDocker環境に近づけます。