【備忘録】WEB開発環境構築:DockerでXserverと同じようなLAMP環境を構築
仮にプロジェクト名を「u-0-project」とする。
1. プロジェクトディレクトリの作成
Ubuntuのターミナル(WSL)を開き、ホームディレクトリ直下にプロジェクトのディレクトリ構成を作成します。
# プロジェクトルートと必要なディレクトリの作成
mkdir -p ~/projects/u-0-project/{src,docker/php,.github/workflows}
cd ~/projects/u-0-project現在のディレクトリ(~/projects/u-0-project)をVSCodeで開きます。
code .2. Docker環境の定義
Xserverの環境(Apache 2.4, PHP 8.4系, MariaDB 10.5)を再現し、MailpitとphpMyAdminを組み合わせます。
compose.yaml
プロジェクトのルートディレクトリに compose.yaml を作成します。
services:
web:
build: ./docker/php
ports:
- "8000:80"
volumes:
- ./src:/var/www/html
# Xserverから取得したphp.iniをマウント
- ./docker/php/php.ini:/usr/local/etc/php/php.ini
environment:
TZ: Asia/Tokyo
depends_on:
- db
- mail
db:
image: mariadb:10.5
environment:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: xserver_db
MYSQL_USER: xserver_user
MYSQL_PASSWORD: password
TZ: Asia/Tokyo
volumes:
- db_data:/var/lib/mysql
phpmyadmin:
image: phpmyadmin/phpmyadmin
ports:
- "8080:80"
environment:
PMA_HOST: db
MYSQL_ROOT_PASSWORD: root
TZ: Asia/Tokyo
depends_on:
- db
mail:
image: axllent/mailpit
ports:
- "1025:1025" # SMTPポート
- "8025:8025" # Web UIポート (ブラウザで確認用)
environment:
TZ: Asia/Tokyo
volumes:
- mail_data:/data
volumes:
db_data:
mail_data:docker/php/Dockerfile
docker/php/ ディレクトリ内に Dockerfile を作成します。Xserverと同様に .htaccess でのリダイレクトが機能するように mod_rewrite を有効化し、Mailpitへメールを送信するためのツール(mhsendmail)を導入します。
FROM php:8.4-apache
# Composerのインストール
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# 必要なパッケージとPHP拡張モジュールのインストール (zip等を追加)
RUN apt-get update && apt-get install -y \
git \
unzip \
libonig-dev \
libmariadb-dev \
libzip-dev \
&& docker-php-ext-install pdo_mysql mysqli mbstring zip
# mod_rewrite を有効化
RUN a2enmod rewrite
# Mailpit(SMTP)へのルーティング用ツール
RUN curl -sSL https://github.com/mailhog/mhsendmail/releases/download/v0.2.0/mhsendmail_linux_amd64 -o mhsendmail \
&& chmod +x mhsendmail \
&& mv mhsendmail /usr/local/bin/mhsendmail3. 設定ファイルとソースコードの配置
docker/php/php.ini
Xserverのサーバーパネルから取得した php.ini を docker/php/ 内に配置します。 配置後、Mailpitでメールを捕捉できるように、ファイルの末尾(または該当箇所)を以下のように編集・追記してください。
; === Xserverの記述そのまま ===
; (Xserverのphp.iniの内容をここにペースト)
; === ローカル開発(Mailpit)用の上書き設定 ===
[mail function]
sendmail_path = "/usr/local/bin/mhsendmail --smtp-addr=mail:1025"src/index.php
動作確認用のサンプルコードを src/ ディレクトリに作成します。
<?php
phpinfo();
?>4. コンテナの起動と動作確認
ターミナルで以下のコマンドを実行し、環境を構築・起動します。
docker compose up --detach --build起動後、ブラウザで以下のURLにアクセスし、正しく表示されるか確認します。
Webサーバ (PHP確認):
http://localhost:8000 (phpinfoの画面が表示されれば成功です)phpMyAdmin:
http://localhost:8080 (ユーザー: root, パスワード: root でログイン)Mailpit (Web UI):
http://localhost:8025
コンテナなどを全て削除
docker compose down --rmi all --volumes