【コンテナ技術】第2回:PHP+Nginx+MariaDB構成の最小構成 ― 業務で使えるDocker環境を作る|現場で困らないDocker ― 設計・運用の実務ガイド

   夜空を飛ぶコンテナを背負ったdockerクジラ

はじめに

前回は「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環境に近づけます。