メインコンテンツへスキップ

【備忘録】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/mhsendmail

    3. 設定ファイルとソースコードの配置

    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


    この記事が参加している募集

     
     
    私は『ITアーティスト』です。 お笑い、音楽、ラジオ、本が好きです。 https://u-0.dev/

    あなたへのおすすめ