Docker で Apache + PHP コンテナを作る方法

ドキュメントルートを変更するには、Apache の設定ファイルを書き換える必要がありますので Dockerfile を使用するように変更しましょう。 Dockerfile を下記のような記述にして作成すると、ドキュメントルートを変更できるようになります。 Apache の設定ファイルは "/etc/apache2" ディレクトリ配下にあります。

FROM php:8.2-apache

# ドキュメントルートを変更
ENV APACHE_DOCUMENT_ROOT /path/to/new/root
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf

version: "3.8"
services:

  # Apache コンテナ
  apache:
    build: ./apache-custom
    ports:
      - 8080:80
    volumes:
      - ./html:/path/to/new/root

version: "3.8"
services:

  # Apache コンテナ
  apache:
    build: ./apache-custom
    ports:
      - 8080:80
    volumes:
      - ./html:/path/to/example/root
    environment:
      APACHE_DOCUMENT_ROOT: /path/to/example/root

デフォルトだと mod_rewrite などの Apache のモジュールが有効になっていないので、 必要なモジュールがあれば有効化しましょう。

apachectl -M

FROM php:8.2-apache

# Apache のモジュールを有効化
RUN a2enmod deflate expires rewrite

デフォルトの PHP だといろいろ困ると思いますので、PHP のエクステンションをインストールしましょう。

ただ、Docker に PHP のエクステンションをインストールするのはかなり大変です。 エクステンションごとに依存しているライブラリが違っていますし、ライブラリのバージョンが違っていれば正しく動きませんし、インストール方法もそれぞれ異なっていたりします。 下手をすると、ライブラリをソースコードからビルドしなければならなくなったりします。 特に PHP 8.1 から追加された AVIF を使用する GD エクステンションを手動でインストールするのはかなり大変です。

そこで、install-php-extensions コマンドを使用すると良いでしょう。 公式でも紹介されている方法なので安心してください。 エクステンションをインストールする際に必要な作業は、このコマンドが全てやってくれます。 ImageMagick や Xdebug などもこのコマンド1つでインストールできるので、かなり便利だと思います。

• mlocati/docker-php-extension-installer: Easily install PHP extension in Docker containers

FROM php:8.2-apache

# install-php-extensions をインストール
ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
RUN chmod +x /usr/local/bin/install-php-extensions

FROM php:8.2-apache

# install-php-extensions をインストール
ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
RUN chmod +x /usr/local/bin/install-php-extensions

# PHP のエクステンションをインストール
RUN install-php-extensions opcache intl gd exif imagick mysqli pdo_mysql redis xdebug

FROM php:8.2-apache

# install-php-extensions をインストール
ADD https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
RUN chmod +x /usr/local/bin/install-php-extensions

# PHP のエクステンションをインストール
RUN install-php-extensions opcache
RUN install-php-extensions intl
RUN install-php-extensions gd
RUN install-php-extensions exif
RUN install-php-extensions imagick
RUN install-php-extensions mysqli
RUN install-php-extensions pdo_mysql
RUN install-php-extensions redis
RUN install-php-extensions xdebug

PHP の設定を変更したい場合は、PHP の設定ファイルである php.ini を使用すると良いでしょう。 PHP の設定ファイルの場所は "/usr/local/etc/php/php.ini" になります。

version: "3.8"
services:

  # Apache コンテナ
  apache:
    build: ./apache-custom
    ports:
      - 8080:80
    volumes:
      - ./php.ini:/usr/local/etc/php/php.ini
      - ./html:/var/www/html

FROM php:8.2-apache

# PHP の設定ファイルを配置
COPY ./php.ini /usr/local/etc/php/php.ini
RUN chmod 644 /usr/local/etc/php/php.ini

まずはデフォルトのサイト設定が邪魔にならないよう無効化しておきましょう。 無効化しなくても良いと言えば良いのですが、バーチャルホストを使って複数サイトを管理するならおそらく使用しないと思います。

サイトの設定を無効化するには、a2dissite コマンドを使用します。 デフォルトのサイト設定は、設定ファイルが "000-default.conf" という名前になっていますので、 a2dissite 000-default と実行します。

FROM php:8.2-apache

# デフォルトのサイト設定を無効化
RUN a2dissite 000-default

次にバーチャルホストを使用したい各サイトの設定ファイルを追加します。

各サイトの設定ファイルを "/etc/apache2/sites-available" ディレクトリの配下に置いて、 a2ensite コマンドで有効化していきます。 a2ensite コマンドを使用せずに、 直接 "/etc/apache2/sites-enabled" ディレクトリの配下に置いても良い気もしますが、 ここでは説明のためにちゃんとした手順を記載しておきます。

サイトの設定ファイルはアルファベット順に読み込まれます。 優先順位を付けたい場合は、ファイルの名前の先頭に番号を付けておくと良いでしょう。 どのサイトのホスト名にも一致しない URL が指定された場合、最初に読み込まれた設定ファイルのサイトが表示されます。 デフォルトのサイト設定のファイルの名前が "000-default.conf" になっているのはそのためです。

<VirtualHost *:80>
    ServerName site1.localhost
    DocumentRoot "/path/to/site1/root"
</VirtualHost>

<Directory "/path/to/site1/root">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

<VirtualHost *:80>
    ServerName site2.localhost
    DocumentRoot "/path/to/site2/root"
</VirtualHost>

<Directory "/path/to/site2/root">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

FROM php:8.2-apache

# デフォルトのサイト設定を無効化
RUN a2dissite 000-default

# サイト1の設定を追加して有効化
COPY ./001-site1.conf /etc/apache2/sites-available/001-site1.conf
RUN a2ensite 001-site1

# サイト2の設定を追加して有効化
COPY ./002-site2.conf /etc/apache2/sites-available/002-site2.conf
RUN a2ensite 002-site2

最後に各サイトのドキュメントルートにバインドマウントして、表示したいファイルを配置します。

version: "3.8"
services:

  # Apache コンテナ
  apache:
    build: ./apache-custom
    ports:
      - 8080:80
    volumes:
      - ./site1_html:/path/to/site1/root
      - ./site2_html:/path/to/site2/root