コンテナ - LAMP

概要

LAMP環境とは、Linux、Apache、MySQL または MariaDB、PHPを組み合わせたWebアプリケーション開発・運用のための基盤環境である。

Docker ComposeまたはPodman Composeを使用することで、これらのコンポーネントを個別のコンテナとして構築し、相互に連携させることができる。
コンテナ化によって、環境の再現性が高まり、開発環境と本番環境の差異を最小限に抑えることが可能となる。

対応バージョン（最新安定版）

本手順では、以下の最新安定版を使用する。

• Apache 2.4.66
• MySQL 8.4 LTS または MariaDB 11.8 LTS
• PHP 8.4

これらのバージョンは、いずれも本番環境での使用に適した安定版であり、長期サポートが提供されている。

LAMP環境の各コンポーネント

LAMP環境の各コンポーネントは以下の役割を担う。

• Linux

  コンテナのベースとなるオペレーティングシステム (Alpine、Debian、Ubuntuなど)

• Apache

  HTTPサーバとして動作し、静的ファイルの配信やPHPスクリプトの実行を担当する

• MySQL / MariaDB

  リレーショナルデータベースとしてアプリケーションのデータを永続化する

• PHP

  サーバサイドのスクリプト言語として動的なWebページを生成する

Docker ComposeまたはPodman Composeを使用することにより、LAMP環境を効率的に構築・管理できる。
コンテナ化によって、開発環境の再現性が高まり、チーム内での環境統一も容易になる。

主な特徴

• Apache2、MySQL、PHPが独立したコンテナとして動作する。
• 設定ファイルやデータは、ホスト側で管理され永続化される。
• 環境変数を使用することで、設定の柔軟性が高い。
• phpMyAdminにより、データベースの視覚的な管理が可能である。
• SSL対応により、HTTPS通信をサポートできる。

開発環境として使用する場合は、Xdebugやホットリロード機能を追加することで、さらに開発効率を向上させることができる。
ただし、本番環境では、セキュリティ設定を強化し、適切なバックアップを実施することが重要である。

環境の前提条件

LAMP環境を構築する前に、以下に示すソフトウェアがインストールされている必要がある。

Docker環境の場合

• Docker Engine (バージョン20.10以降を推奨)
• Docker Compose (バージョン2.0以降を推奨)

Podman環境の場合

• Podman (バージョン4.0以降を推奨)
• Podman Compose (バージョン1.0以降を推奨)

インストール状況の確認は以下のコマンドで行う。

podman --version
podman-compose --version

ディレクトリ構成

LAMP環境を構築するために、ディレクトリ構成を作成する。
以下に示す構成は、各コンポーネントの設定ファイルやデータを整理して管理するためのものである。

lamp-project/
├── docker-compose.yml         # Compose設定ファイル (または、compose.yml)
├── apache/
│   ├── Dockerfile             # Apache用のDockerfile (カスタマイズする場合)
│   └── httpd.conf             # Apache設定ファイル (カスタマイズする場合)
├── php/
│   ├── Dockerfile             # PHP用のDockerfile (拡張モジュールを追加する場合)
│   └── php.ini                # PHP設定ファイル
├── mysql/
│   ├── conf.d/
│   │   └── my.cnf             # MySQL設定ファイル
│   └── init/
│       └── 01-init.sql        # 初期化SQLスクリプト
└── www/
    └── html/
        └── index.php          # Webコンテンツのルートディレクトリ

基本的なCompose設定

LAMP環境を構築するためのCompose設定ファイルを作成する。
この設定では、Apache、MySQL または MariaDB、PHPの3つのサービスを定義して、それぞれを連携させる。

docker-compose.yml または compose.yml という名前でファイルを作成する。

以下の例では、最新の安定版バージョンを使用している。

• Apache 2.4 + PHP 8.4 統合イメージ (php:8.4-apache)
• MySQL 8.4 LTS
• phpMyAdmin (最新版)

ヘルスチェックの設定も含まれており、MySQLコンテナが完全に起動するまで待機してから、Webサーバがデータベースへの接続を試みることができる。

 version: '3.8'
 
 services:
   # Webサーバ (Apache + PHP)
   web:
     build:
       context: ./php
       dockerfile: Dockerfile
     container_name: lamp-web
     ports:
       - "0.0.0.0:8080:80"
     volumes:
       - ./www/html:/var/www/html
       - ./apache/logs:/var/log/apache2
     environment:
       - APACHE_RUN_USER=www-data
       - APACHE_RUN_GROUP=www-data
     depends_on:
       db:
         condition: service_healthy
     networks:
       - lamp-network
     restart: unless-stopped
 
   # データベースサーバ (MySQL 8.4 LTS)
   db:
     image: mysql:8.4
     container_name: lamp-db
     environment:
       MYSQL_ROOT_PASSWORD: rootpassword
       MYSQL_DATABASE: myapp
       MYSQL_USER: dbuser
       MYSQL_PASSWORD: dbpassword
     volumes:
       - mysql-data:/var/lib/mysql
       - ./mysql/init:/docker-entrypoint-initdb.d
       - ./mysql/conf.d:/etc/mysql/conf.d
     ports:
       - "0.0.0.0:3306:3306"
     networks:
       - lamp-network
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$MYSQL_ROOT_PASSWORD"]
       interval: 10s
       timeout: 5s
       retries: 5
       start_period: 30s
 
   # データベース管理ツール (phpMyAdmin)
   phpmyadmin:
     image: phpmyadmin:latest
     container_name: lamp-phpmyadmin
     environment:
       PMA_HOST: db
       PMA_PORT: 3306
       PMA_USER: root
       PMA_PASSWORD: rootpassword
     ports:
       - "0.0.0.0:8081:80"
     depends_on:
       db:
         condition: service_healthy
     networks:
       - lamp-network
     restart: unless-stopped
 
 # 永続化ボリュームの定義
 volumes:
   mysql-data:
     driver: local
 
 # ネットワークの定義
 networks:
   lamp-network:
     driver: bridge

この設定ファイルでは、php:8.4-apacheという公式イメージをベースとして使用している。
このイメージにはApache 2.4とPHP 8.4が統合されており、追加の設定なしでPHPスクリプトを実行できる。

データベースとしてはMySQL 8.4 LTSを使用し、環境変数でデータベース名やユーザ情報を設定している。

depends_onディレクティブに condition: service_healthy を追加することで、データベースのヘルスチェックが成功するまでWebサービスの起動を待機できる。
また、両サービスはlamp-networkという専用のネットワークで接続され、サービス名 (上記の例では、db) でお互いに通信できる。

コンテナの起動と動作確認

Compose設定ファイルを作成したら、以下のコマンドでコンテナを起動する。

Docker Composeの場合

docker-compose up -d

または、Docker Compose V2の場合は以下のコマンドでも起動できる。

docker compose up -d

起動したコンテナの状態を確認するには、以下のコマンドを実行する。

Docker Composeの場合

docker-compose ps

Podman Composeの場合

podman-compose up -d

起動したコンテナの状態を確認するには、以下のコマンドを実行する。

Podman Composeの場合

podman-compose ps

正常に起動している場合は、webとdbの2つのコンテナがUpステータスで表示される。

初回起動時の注意点

MySQLコンテナは初回起動時にデータベースの初期化を行うため、完全に起動するまで数十秒かかる場合がある。
ログを確認して、MySQLが完全に起動したことを確認する。

docker-compose logs -f db
# または
podman-compose logs -f db

ready for connections というメッセージが表示されている場合、MySQLの起動が完了している。

PHPの動作確認

phpinfo()による確認

www/html/index.phpファイルを作成し、以下に示す内容を記述する。

 <?php
 phpinfo();
 ?>

Webブラウザで http://localhost:8080 にアクセスすると、PHPの詳細情報が表示される。
この画面では、PHPのバージョンや有効な拡張モジュール、Apache環境変数等を確認することができる。
PHP 8.4の機能や設定が正しく適用されているかを確認する。

データベース接続の確認

次に、PHPからMySQLへの接続を確認する。
www/html/db-test.phpファイルを作成し、以下に示す内容を記述する。

 <?php
 $servername = "db";  // Composeファイルで定義したサービス名
 $username = "dbuser";
 $password = "dbpassword";
 $database = "myapp";
 
 try {
    // PDOを使用した接続
    // DSN（Data Source Name）を構築してデータベースに接続
    $conn = new PDO(
       "mysql:host=$servername;dbname=$database;charset=utf8mb4",
       $username,
       $password
    );
 
   // エラーモードを例外に設定 (データベース操作でエラーが発生した時に例外をスローする)
   $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 
   // 接続成功メッセージ
   echo "接続情報: MySQL via PDO<br>";
 
   // サーバーバージョンの表示 (MySQLiのhost_infoに相当する情報)
   echo "サーバーバージョン: " . $conn->getAttribute(PDO::ATTR_SERVER_VERSION) . "<br>";
 }
 catch (PDOException $e) {
    // 接続エラーが発生した場合の処理
    die("接続失敗: " . $e->getMessage());
 }
 
 // PDOの場合、接続は自動的にスクリプト終了時にクローズされる
 // 明示的にクローズする場合は以下のように記述する
 $conn = null;
 ?>

http://localhost:8080/db-test.php にアクセスして、接続成功メッセージが表示される場合はPHPおよびMySQL間の連携が正常に動作している。

PHP拡張モジュールの追加

基本的なphp:8.4-apacheイメージには、最小限の拡張モジュールしか含まれていない。
多くのWebアプリケーションでは、追加の拡張モジュールが必要となる。

Dockerfileの作成

php/Dockerfileを作成して、必要な拡張モジュールをインストールする設定を記述する。

以下の例では、画像処理 (gd)、データベース接続 (mysqli、pdo_mysql)、文字列処理 (mbstring)、ファイル圧縮 (zip) 等の一般的な拡張モジュールをインストールしている。

 FROM php:8.4-apache
 
 # システムパッケージの更新と必要なライブラリのインストール
 RUN apt-get update && apt-get install -y \
     libpng-dev \
     libjpeg-dev \
     libfreetype6-dev \
     libzip-dev \
     libonig-dev \
     libxml2-dev \
     && rm -rf /var/lib/apt/lists/*
 
 # PHP拡張モジュールのインストール
 RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
     && docker-php-ext-install -j$(nproc) \
     gd \
     mysqli \
     pdo \
     pdo_mysql \
     mbstring \
     zip \
     exif \
     pcntl \
     bcmath \
     opcache
 
 # Apacheのmod_rewriteを有効化
 RUN a2enmod rewrite
 
 # 作業ディレクトリの設定
 WORKDIR /var/www/html

Composeファイルの更新

Composeファイルを以下に示すように修正する。

   web:
     build:
       context: ./php
       dockerfile: Dockerfile
     container_name: lamp-web
     ports:
       - "0.0.0.0:8080:80"
     volumes:
       - ./www/html:/var/www/html
     depends_on:
       db:
         condition: service_healthy
     networks:
       - lamp-network
     restart: unless-stopped

imageディレクティブの代わりにbuildディレクティブを使用することにより、Dockerfileからイメージをビルドすることができる。

ビルドして起動する。

docker-compose up -d --build
# または
podman-compose up -d --build

PHP設定のカスタマイズ

PHPの動作をカスタマイズするため、php.iniファイルを作成および設定する。

カスタムphp.iniの作成

php/php.iniファイルを作成して、必要な設定を記述する。

以下の例では、実行時間の上限、メモリ制限、アップロードファイルサイズ等を調整している。
PHP 8.4では、OPcacheやJITコンパイラの設定も重要である。

開発環境ではエラーを画面に表示させることにより、問題の早期発見が可能になる。
本番環境では、セキュリティの観点からエラーをログファイルに記録する設定に切り替えることが推奨される。

 ; 基本設定
 max_execution_time = 300
 max_input_time = 300
 memory_limit = 256M
 
 ; アップロード設定
 upload_max_filesize = 64M
 post_max_size = 64M
 
 ; エラー表示設定 (開発環境用)
 display_errors = On
 display_startup_errors = On
 error_reporting = E_ALL
 
 ; 本番環境用設定 (本番環境ではこちらを使用)
 ; display_errors = Off
 ; display_startup_errors = Off
 ; error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
 ; log_errors = On
 ; error_log = /var/log/php/error.log
 
 ; タイムゾーン設定
 date.timezone = Asia/Tokyo
 
 ; セッション設定
 session.save_handler = files
 session.save_path = "/tmp"
 session.gc_maxlifetime = 1440
 
 ; OPcache設定 (PHP 8.4でのパフォーマンス向上)
 opcache.enable = 1
 opcache.memory_consumption = 128
 opcache.interned_strings_buffer = 8
 opcache.max_accelerated_files = 10000
 opcache.revalidate_freq = 2
 opcache.validate_timestamps = 1
 
 ; JITコンパイラ設定 (PHP 8.4の機能)
 ; 本番環境では有効化を検討
 opcache.jit = tracing
 opcache.jit_buffer_size = 100M

Dockerfileの更新

作成したphp.iniをコンテナにコピーするため、php/Dockerfileに以下の行を追加する。

 # カスタムphp.iniのコピー
 COPY php.ini /usr/local/etc/php/conf.d/custom.ini

この設定により、カスタムphp.iniが読み込まれ、デフォルト設定が上書きされる。

Apache設定

Apacheの設定をカスタマイズすることにより、仮想ホストの設定やmod_rewriteの有効化などを行える。

.htaccessの有効化

多くのPHPアプリケーション (WordPress等) は.htaccessファイルを使用してURLの書き換えを行う。
これを有効にするため、AllowOverrideディレクティブを設定する必要がある。

apache/000-default.confファイルを作成し、以下の内容を記述する。

 <VirtualHost *:80>
     ServerAdmin webmaster@localhost
     DocumentRoot /var/www/html
 
     <Directory /var/www/html>
         Options Indexes FollowSymLinks
         AllowOverride All
         Require all granted
     </Directory>
 
     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
 </VirtualHost>

この設定では、AllowOverride Allを指定することにより、.htaccessファイルによるディレクトリ単位の設定変更を許可している。

Dockerfileへの追加

php/Dockerfileに、この設定ファイルをコピーする行を追加する。

 # Apache設定のコピー
 COPY ../apache/000-default.conf /etc/apache2/sites-available/000-default.conf

MySQL初期化スクリプト

コンテナ起動時に自動的にデータベーステーブルを作成、あるいは、初期データを投入する場合、初期化スクリプトを使用する。

初期化SQLの作成

mysql/init/01-init.sqlファイルを作成して、テーブル定義やサンプルデータを記述する。

 -- データベースの使用
 USE myapp;
 
 -- ユーザテーブルの作成
 CREATE TABLE IF NOT EXISTS users (
     id INT AUTO_INCREMENT PRIMARY KEY,
     username VARCHAR(50) NOT NULL UNIQUE,
     email VARCHAR(100) NOT NULL UNIQUE,
     password_hash VARCHAR(255) NOT NULL,
     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
     updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
 
 -- 記事テーブルの作成
 CREATE TABLE IF NOT EXISTS posts (
     id INT AUTO_INCREMENT PRIMARY KEY,
     user_id INT NOT NULL,
     title VARCHAR(200) NOT NULL,
     content TEXT,
     published BOOLEAN DEFAULT FALSE,
     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
     updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
     FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
 
 -- サンプルデータの挿入
 INSERT INTO users (username, email, password_hash) VALUES
 ('admin', 'admin@example.com', '$2y$10$abcdefghijklmnopqrstuvwxyz1234567890'),
 ('testuser', 'test@example.com', '$2y$10$1234567890abcdefghijklmnopqrstuvwxyz');
 
 INSERT INTO posts (user_id, title, content, published) VALUES
 (1, '最初の投稿', 'これはテスト投稿です。', TRUE),
 (1, '2番目の投稿', 'もう一つのテスト投稿です。', TRUE),
 (2, 'ユーザ投稿', 'テストユーザからの投稿です。', FALSE);

このSQLファイルは、MySQLコンテナの初回起動時に自動的に実行される。
/docker-entrypoint-initdb.dディレクトリに配置されたSQLファイルは、ファイル名の昇順で実行されるため、複数のファイルを使用する場合は 01-、02- のように番号を付加して実行順序を制御できる。

MySQL設定のカスタマイズ

MySQLの動作をカスタマイズするため、設定ファイルを作成する。

カスタムmy.cnfの作成

mysql/conf.d/my.cnfファイルを作成して、以下に示す内容を記述する。

以下の例では、文字コードをutf8mb4、日本時間 (UTC+9) を設定している。
また、パフォーマンスチューニングのためのバッファサイズやスロークエリログの設定も含まれている。

 [mysqld]
 # 文字コード設定
 character-set-server = utf8mb4
 collation-server = utf8mb4_unicode_ci
 
 # タイムゾーン設定
 default-time-zone = '+09:00'
 
 # 接続設定
 max_connections = 200
 max_connect_errors = 100
 
 # パフォーマンス設定
 innodb_buffer_pool_size = 256M
 innodb_log_file_size = 64M
 innodb_flush_log_at_trx_commit = 2
 
 # ログ設定
 slow_query_log = 1
 slow_query_log_file = /var/log/mysql/slow-query.log
 long_query_time = 2
 
 # バイナリログ設定 (レプリケーション用)
 # server-id = 1
 # log_bin = /var/log/mysql/mysql-bin.log
 # binlog_expire_logs_seconds = 604800  # MySQL 8.0以降では expire_logs_days の代わりに使用
 
 [client]
 default-character-set = utf8mb4

Compose設定への追加

Composeファイルのdbサービスに、設定ファイルをマウントする設定を追加する。

   db:
     image: mysql:8.4
     container_name: lamp-db
     environment:
       MYSQL_ROOT_PASSWORD: rootpassword
       MYSQL_DATABASE: myapp
       MYSQL_USER: dbuser
       MYSQL_PASSWORD: dbpassword
     volumes:
       - mysql-data:/var/lib/mysql
       - ./mysql/init:/docker-entrypoint-initdb.d
       - ./mysql/conf.d:/etc/mysql/conf.d
     networks:
       - lamp-network
     restart: unless-stopped

phpMyAdminの追加

データベースを視覚的に管理するため、phpMyAdminを追加することができる。
phpMyAdminは、Webブラウザ上でデータベースの操作が可能なツールである。

Compose設定への追加

Composeファイルに、phpMyAdminサービスを追加する。

以下の例では、http://localhost:8081 でphpMyAdminにアクセスできるようになる。
ログイン画面では、Composeファイルで指定したデータベースユーザ (dbuser) または rootユーザ でログインできる。

   phpmyadmin:
     image: phpmyadmin:latest
     container_name: lamp-phpmyadmin
     environment:
       PMA_HOST: db
       PMA_PORT: 3306
       PMA_USER: root
       PMA_PASSWORD: rootpassword
     ports:
       - "0.0.0.0:8081:80"
     depends_on:
       db:
         condition: service_healthy
     networks:
       - lamp-network
     restart: unless-stopped

アクセス方法とテスト

コンテナを起動した後、以下のURLでそれぞれのサービスにアクセスできる。

Webサーバ

http://localhost:8080 にアクセスすると、./www/html/index.phpの内容が表示される。

phpMyAdmin

http://localhost:8081 にアクセスすると、phpMyAdminのログイン画面が表示される。以下のいずれかの認証情報でログインできる。

管理者ユーザの場合

• ユーザ名: root
• パスワード: rootpassword

一般ユーザの場合

• ユーザ名: dbuser
• パスワード: dbpassword

データベース接続テスト

PHPからMySQLへの接続をテストするため、./www/html/db-connect.phpファイルを作成する。

 <?php
 // データベース接続設定
 $host = 'db';  // Composeで定義したサービス名
 $dbname = 'myapp';
 $username = 'dbuser';
 $password = 'dbpassword';
 
 try {
     // PDOを使用した接続
     $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $username, $password);
     $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
     
     echo "<h2>データベース接続成功！</h2>";
     
     // MySQLバージョン情報の表示
     $version = $pdo->getAttribute(PDO::ATTR_SERVER_VERSION);
     echo "<p>MySQLバージョン: " . htmlspecialchars($version) . "</p>";
     
     // ユーザテーブルの内容を取得
     $stmt = $pdo->query("SELECT * FROM users");
     $users = $stmt->fetchAll(PDO::FETCH_ASSOC);
     
     echo "<h3>登録ユーザ一覧</h3>";
     echo "<table border='1' cellpadding='5'>";
     echo "<tr><th>ID</th><th>ユーザ名</th><th>メールアドレス</th><th>登録日時</th></tr>";
     
     foreach ($users as $user) {
         echo "<tr>";
         echo "<td>" . htmlspecialchars($user['id']) . "</td>";
         echo "<td>" . htmlspecialchars($user['username']) . "</td>";
         echo "<td>" . htmlspecialchars($user['email']) . "</td>";
         echo "<td>" . htmlspecialchars($user['created_at']) . "</td>";
         echo "</tr>";
     }
     
     echo "</table>";
     
 } catch (PDOException $e) {
     echo "<h2>データベース接続エラー</h2>";
     echo "<p>エラー内容: " . htmlspecialchars($e->getMessage()) . "</p>";
 }
 ?>

http://localhost:8080/db-connect.php にアクセスして、ユーザ一覧が表示されれば、LAMP環境が正しく動作している。

MariaDBを使用する場合

MySQLの代わりにMariaDBを使用することもできる。
MariaDBはMySQLのフォーク版であり、互換性がある。

Compose設定の変更

Composeファイルのdbサービスを、以下に示すように変更する。

主な変更点は、イメージ名を mariadb:11.8、環境変数名を MARIADB_ で始まるものに変更している点である。
ボリューム名も mysql-data から mariadb-data に変更することが推奨される。

   db:
     image: mariadb:11.8
     container_name: lamp-mariadb
     environment:
       MARIADB_ROOT_PASSWORD: rootpassword
       MARIADB_DATABASE: myapp
       MARIADB_USER: dbuser
       MARIADB_PASSWORD: dbpassword
     volumes:
       - mariadb-data:/var/lib/mysql
       - ./mysql/init:/docker-entrypoint-initdb.d
       - ./mysql/conf.d:/etc/mysql/conf.d
     ports:
       - "0.0.0.0:3306:3306"
     networks:
       - lamp-network
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
       interval: 10s
       timeout: 5s
       retries: 5
       start_period: 30s

MariaDB 12.1は最新の機能を提供しており、MariaDB 11.8はLTS版として長期サポートが提供される。
用途に応じて適切なバージョンを選択する。

環境変数ファイルの使用

パスワード等の機密情報をCompose設定ファイルに直接記述するのではなく、.envファイルに分離することができる。
これにより、設定ファイルをバージョン管理システムで管理する際に、機密情報を除外できる。

.envファイルの作成

プロジェクトルートに.envファイルを作成して、環境変数を定義する。

 # データベース設定
 MYSQL_ROOT_PASSWORD=rootpassword
 MYSQL_DATABASE=myapp
 MYSQL_USER=dbuser
 MYSQL_PASSWORD=dbpassword
 
 # データベースバージョン (MySQL 8.4 LTS または MariaDB 11.8 LTS 推奨)
 DB_VERSION=8.4
 
 # Webサーバ設定
 WEB_PORT=8080
 
 # phpMyAdmin設定
 PMA_PORT=8081

Composeファイルの更新

Composeファイルを編集して、環境変数を参照するように変更する。
これにより、開発環境と本番環境で異なる設定値を使用する場合でも、Composeファイルを変更する必要がなくなる。

.envファイルを.gitignoreに追加して、バージョン管理から除外する。

   db:
     image: mysql:${DB_VERSION}
     container_name: lamp-db
     environment:
       MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
       MYSQL_DATABASE: ${MYSQL_DATABASE}
       MYSQL_USER: ${MYSQL_USER}
       MYSQL_PASSWORD: ${MYSQL_PASSWORD}
     # ... 以下省略
 
   web:
     build:
       context: ./php
       dockerfile: Dockerfile
     container_name: lamp-web
     ports:
       - "0.0.0.0:${WEB_PORT}:80"
     # ... 以下省略

データの永続化とバックアップ

コンテナを削除してもデータを保持するため、適切な永続化戦略が必要である。

ボリュームの確認

作成されたボリュームを確認する。

# Docker Composeの場合
docker volume ls

# Podman Composeの場合
podman volume ls

<プロジェクト名>_mysql-data という名前のボリュームが作成されていることを確認する。

データベースのバックアップ

MySQLデータベースの内容をバックアップする。

パスワード入力を求められるので、ルートパスワードを入力する。
バックアップファイルbackup.sqlが作成される。

# Docker Composeの場合
docker-compose exec db mysqldump -u root -p myapp > backup.sql

# Podman Composeの場合
podman-compose exec db mysqldump -u root -p myapp > backup.sql

バックアップの復元

バックアップから復元するには、以下のコマンドを実行する。

docker-compose exec -T db mysql -u root -p myapp < backup.sql
# または
podman-compose exec -T db mysql -u root -p myapp < backup.sql

完全バックアップスクリプト

定期的なバックアップを自動化するため、シェルスクリプトを作成する。

以下の例では、backup.shという名前で以下に示す内容を保存している。

 #!/usr/bin/env sh
 
 # バックアップディレクトリの作成
 BACKUP_DIR="./backups"
 mkdir -p $BACKUP_DIR
 
 # タイムスタンプの生成
 TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
 
 # データベースのバックアップ
 echo "データベースをバックアップしています..."
 docker-compose exec -T db mysqldump -u root -prootpassword --all-databases > "$BACKUP_DIR/mysql_$TIMESTAMP.sql"
 
 # Webコンテンツのバックアップ
 echo "Webコンテンツをバックアップしています..."
 tar -czf "$BACKUP_DIR/www_$TIMESTAMP.tar.gz" ./www
 
 # 古いバックアップの削除 (30日以上前のファイル)
 find $BACKUP_DIR -type f -mtime +30 -delete
 
 echo "バックアップが完了しました: $TIMESTAMP"

スクリプトに実行権限を付与する。

chmod u+x backup.sh

定期的にバックアップを実行するには、cronに登録する。

crontab -e

# 毎日午前3時にバックアップを実行する例
0 3 * * * cd /path/to/lamp-project && ./backup.sh

SSLの設定

HTTPS通信を有効にするため、SSL証明書を設定する。

自己署名証明書の作成

開発環境では、自己署名証明書を使用できる。
例えば、以下に示すコマンドで自己署名証明書を生成することができる。

mkdir -p ./ssl

openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
            -keyout ./ssl/server.key \
            -out ./ssl/server.crt \
            -subj "/C=JP/ST=Tokyo/L=Tokyo/O=Development/CN=localhost"

Apacheのssl.confの作成

apache/ssl.confファイルを作成して、HTTPS設定を記述する。

 <IfModule mod_ssl.c>
     <VirtualHost *:443>
         ServerAdmin webmaster@localhost
         DocumentRoot /var/www/html
 
         SSLEngine on
         SSLCertificateFile /etc/ssl/certs/server.crt
         SSLCertificateKeyFile /etc/ssl/private/server.key
 
         <Directory /var/www/html>
             Options Indexes FollowSymLinks
             AllowOverride All
             Require all granted
         </Directory>
 
         ErrorLog ${APACHE_LOG_DIR}/ssl-error.log
         CustomLog ${APACHE_LOG_DIR}/ssl-access.log combined
     </VirtualHost>
 </IfModule>

Dockerfileの更新

php/Dockerfileに、SSL設定と証明書をコピーする行を追加する。

 # SSLモジュールの有効化
 RUN a2enmod ssl
 RUN a2ensite default-ssl
 
 # SSL証明書のコピー
 COPY ../ssl/server.crt /etc/ssl/certs/server.crt
 COPY ../ssl/server.key /etc/ssl/private/server.key
 
 # SSL設定のコピー
 COPY ../apache/ssl.conf /etc/apache2/sites-available/default-ssl.conf

Compose設定の更新

Composeファイルのwebサービスに、TCP 443番ポートを追加する。

   web:
     build:
       context: ./php
       dockerfile: Dockerfile
     container_name: lamp-web
     ports:
       - "0.0.0.0:8080:80"
       - "0.0.0.0:8443:443"
     # ... 以下省略

再ビルドして起動する。

docker-compose up -d --build
# または
podman-compose up -d --build

https://localhost:8443 にアクセスすると、HTTPSでWebサーバにアクセスできる。
Webブラウザは自己署名証明書の警告を表示するが、開発環境では問題ない。

本番環境では、Let's Encrypt等の認証局から正式な証明書を取得することが推奨される。

Composerのインストール

PHPの依存関係管理ツールであるComposerをコンテナにインストールする方法を説明する。

Dockerfileへの追加

php/Dockerfileファイルに、Composerをインストールする設定を追加する。

 # Composerのインストール
 RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
 
 # Composerのバージョン確認
 RUN composer --version

再ビルド後、コンテナ内でComposerを使用できる。

docker-compose exec web composer --version

プロジェクトでのComposer使用例

Laravel等のフレームワークをインストールする。

docker-compose exec web composer create-project laravel/laravel /var/www/html/laravel

または、既存のcomposer.jsonファイルがある場合は、依存パッケージをインストールする。

docker-compose exec web composer install

Node.jsとnpmの追加

フロントエンドのビルドツールを使用する場合、Node.jsとnpmが必要になることがある。

Dockerfileへの追加

php/Dockerfileファイルに、Node.jsをインストールする設定を追加する。

 # Node.jsとnpmのインストール
 RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
     && apt install -y nodejs \
     && npm install -g npm@latest
 
 # バージョン確認
 RUN node --version && npm --version

これにより、コンテナ内でnpmコマンドを使用できるようになる。

docker-compose exec web npm install
docker-compose exec web npm run build
# または
podman-compose exec web npm install
podman-compose exec web npm run build

開発時の設定

開発効率を向上させるための設定がある。

Xdebugの設定

PHPのデバッグツールXdebugをインストールすることで、ステップ実行やブレークポイント設定が可能になる。

php/Dockerfileに以下に示す設定を追加する。

 # Xdebugのインストール
 RUN pecl install xdebug \
     && docker-php-ext-enable xdebug
 
 # Xdebug設定
 RUN echo "xdebug.mode=develop,debug" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
     && echo "xdebug.client_host=host.docker.internal" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
     && echo "xdebug.start_with_request=yes" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

ホットリロードの設定

ファイル変更を自動的に検知してWebブラウザをリロードするため、ブラウザ拡張機能 (Live Server) や npmパッケージ (browser-sync) が使用できる。

ログの確認を簡単にする

Composeファイルにログ設定を追加することにより、ログの確認が容易になる。

   web:
     # ... 既存の設定
     logging:
       driver: "json-file"
       options:
         max-size: "10m"
         max-file: "3"

トラブルシューティング

コンテナが起動しない

ログを確認して、エラーメッセージを特定する。

docker-compose logs web
docker-compose logs db
# または
podman-compose logs web
podman-compose logs db

設定ファイルの構文エラーがある場合は、以下に示すコマンドで検証する。

docker-compose config
# または
podman-compose config

データベースに接続できない

データベースコンテナが完全に起動するまで待つ必要がある。

まず、ヘルスチェックを確認する。
statusカラムにhealthyと表示されている場合は、接続可能である。

docker-compose ps
# または
podman-compose ps

次に、接続情報が正しいかどうかを確認する。
ホスト名は、Composeファイルで定義したサービス名 (db) を使用する必要がある。
この時、localhost や 127.0.0.1 では接続できない。

ポート番号の競合

既に他のサービスがポートを使用している場合、異なるポート番号に変更する。

ports:
  - "0.0.0.0:8081:80"  # 8080の代わりに8081を使用

パーミッションエラー

ボリュームマウントしたディレクトリのパーミッションを確認する。

sudo chown -R 1000:1000 ./www/html
chmod -R 755 ./www/html

PHP拡張モジュールが見つからない

必要な拡張モジュールがインストールされているか確認する。

docker-compose exec web php -m
# または
podman-compose exec web php -m 

インストールされていない場合は、Dockerfileに追加して再ビルドする。

MySQLの文字化け

文字コード設定を確認する。
phpMyAdmin または コマンドラインで以下に示すクエリを実行する。

SHOW VARIABLES LIKE 'character%';

全てutf8mb4と表示されていることを確認する。
もし異なる場合は、my.cnfの設定を見直す。

コンテナ内のファイルが見えない

ボリュームマウントの設定を確認する。
相対パスが正しいか、ホスト側のディレクトリが存在するかどうかを確認する。

ls -la ./www/html

メモリ不足エラー

Docker Desktop / Podman Desktopの設定で、割り当てメモリを増やす。
また、php.iniの memory_limit を調整する。

パフォーマンス最適化

OPcacheとJITの有効化

php.iniで既に設定したOPcacheとJITコンパイラにより、PHPスクリプトの実行速度が大幅に向上する。
PHP 8.4では、JITコンパイラの最適化がさらに改善されている。

本番環境では、opcache.validate_timestampsを0に設定して、ファイル更新チェックを無効化することで、さらなる高速化が可能である。

MySQLのクエリキャッシュ

MySQL 8.0以降ではクエリキャッシュが廃止されたため、アプリケーション側でキャッシュ (Redis、Memcached等) を使用することが推奨される。

静的ファイルの圧縮

Apacheの mod_deflate を使用して、テキストファイルを圧縮して転送する。

apache/000-default.confファイルに以下に示す設定を追加する。

 <IfModule mod_deflate.c>
     AddOutputFilterByType DEFLATE text/html text/plain text/xml
     AddOutputFilterByType DEFLATE text/css text/javascript
     AddOutputFilterByType DEFLATE application/javascript application/json
 </IfModule>

php/Dockerfileファイルで mod_deflate を有効化する。

RUN a2enmod deflate

セキュリティ対策

本番環境での設定変更

本番環境では、以下に示す設定変更が推奨される。

• php.iniでエラー表示を無効化する。

   display_errors = Off
   log_errors = On
   error_log = /var/log/php/error.log
  

  
  

• 環境変数からパスワードを分離する。

   # 本番環境では.envファイルを使用せず、環境変数を直接設定する
   export MYSQL_ROOT_PASSWORD=$(openssl rand -base64 32)
  

ファイアウォール設定

外部からのアクセスを許可する場合、ファイアウォールでポート開放を行う。

• Linuxの場合
  • firewalld使用時

     sudo firewall-cmd --permanent --add-port=8080/tcp
     sudo firewall-cmd --permanent --add-port=8443/tcp
     sudo firewall-cmd --reload
    

    
    

  • ufw使用時

     sudo ufw allow 8080/tcp
     sudo ufw allow 8443/tcp
     sudo ufw reload
    

  
  

• Windows 11の場合

  
  

  PowerShellを管理者権限で起動する。

  HTTPポートの受信ルールを追加する。

   New-NetFirewallRule -DisplayName "LAMP HTTP" -Direction Inbound -Protocol TCP -LocalPort 8080 -Action Allow
  

  
  

  HTTPSポートの受信ルールを追加する。

   New-NetFirewallRule -DisplayName "LAMP HTTPS" -Direction Inbound -Protocol TCP -LocalPort 8443 -Action Allow
  

  
  

  接続テストを別PCから実行する。

   Test-NetConnection -ComputerName <サーバのIPアドレス> -Port 8080
   Test-NetConnection -ComputerName <サーバのIPアドレス> -Port 8443
  

  
  

  ファイアウォールルールを削除する場合は、以下に示すコマンドを実行する。

   Remove-NetFirewallRule -DisplayName "LAMP HTTP" -ErrorAction SilentlyContinue
   Remove-NetFirewallRule -DisplayName "LAMP HTTPS" -ErrorAction SilentlyContinue
  

コンテナの管理コマンド

コンテナの起動

docker-compose up -d
# または
podman-compose up -d

コンテナの停止

docker-compose down
# または
podman-compose down

データボリュームも削除する場合は、-vオプションを追加する。

docker-compose down -v
# または
podman-compose down -v

コンテナの再起動

docker-compose restart
# または
podman-compose restart

# 特定のサービスのみ再起動する場合

docker-compose restart <サービス名>
# または
podman-compose restart <サービス名>

コンテナのログ確認

docker-compose logs -f <サービス名>
# または
podman-compose logs -f <サービス名>

コンテナ内でコマンド実行

docker-compose exec <サービス名> bash

# 例 : サービス名 (db) のMySQLコンテナの場合
docker-compose exec db mysql -u root -p

# または

podman-compose exec <サービス名> bash

# 例 : サービス名 (db) のMySQLコンテナの場合
podman-compose exec db mysql -u root -p

イメージの再ビルド

docker-compose build
docker-compose up -d --build
# または
podman-compose build
podman-compose up -d --build

リソース使用状況の確認

docker stats
# または
podman stats

バージョン別の注意事項

PHP 8.4の特徴

PHP 8.4では、以下の機能が追加または改善されている。

• プロパティフック機能の追加
• 非対称可視性プロパティのサポート
• JITコンパイラのさらなる最適化
• 新しい配列関数の追加
• パフォーマンスの全般的な向上

MySQL 8.4 LTSの特徴

MySQL 8.4は長期サポート版 (LTS) として提供されており、本番環境での使用に最適である。

• 安定性と信頼性が検証されている。
• セキュリティアップデートが長期間提供される。
• パフォーマンスが最適化されている。
• 豊富なドキュメントとコミュニティサポート

MariaDB 11.8 LTSの特徴

MariaDB 11.8は長期サポート版（LTS）として提供されており、本番環境での使用に最適である。

• MySQLとの高い互換性
• 安定性と信頼性が検証されている
• パフォーマンスの向上
• セキュリティ機能の改善