「WordPress」をDockerで環境構築（Windows、M4 MacはARM64）WP本体をドキュメントルート直下ではなくサブディレクトリ配置する場合やphp.iniカスタムについても解説

2023年4月21日2026年3月8日

【簡単】WordPress環境をDockerで構築手順

1）作業フォルダを作成

2）1）内に「docker-compose.yml」を作成

services:
  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: somewordpress
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
    
  wordpress:
    depends_on:
      - db
    image: wordpress:latest
    ports:
      - "8080:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./wordpress:/var/www/html

      # 開発テーマ以外は同期せずコピー（表示早くなります、快適）
      # - ./wordpress/wp/wp-content/themes/hello:/var/www/html/wp/wp-content/themes/hello

      # debug.logはバインドマウント（エラーログ見たいとき）
      # - ./wordpress/wp/wp-content/debug.log:/var/www/html/wp/wp-content/debug.log

volumes:
  db_data:

volumesは画像のパス等にあわせてください

3）作業ディレクトリにて下記コマンド

docker-compose up -d

多少時間がかかるかもしれません。

4）「Docker Desktop」で確認

エラーログの確認方法

1. Dockerコンテナ内でWordPressのエラーログを有効化

まず、WordPressのwp-config.phpにエラーログを有効にする設定を追加します。

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

この設定により、エラーログがwp-content/debug.logに保存されます。

2. Dockerコンテナ内でエラーログを確認する

方法1: docker-compose execでコンテナ内に入って確認

Dockerコンテナ内に直接アクセスして、エラーログを確認することができます。

docker-compose exec <コンテナ名> bash

コンテナ内に入ったら、エラーログファイルにアクセスします。

cat /var/www/html/wp-content/debug.log

※ <コンテナ名> は、WordPressが稼働しているコンテナの名前に置き換えてください。

方法2: docker-compose logsでコンテナのログを直接表示

WordPressやApache/Nginxのエラーログは、コンテナの標準出力にも表示される場合があります。以下のコマンドでログ全体を確認できます。

docker-compose logs -f <コンテナ名>

上記コマンドで、リアルタイムにエラーログを追跡しながら確認できます。

方法3: ログファイルをホストマシンにマウント

Dockerのdocker-compose.ymlファイルで、WordPressのwp-contentディレクトリをホストマシンと共有すると、ホスト側で直接debug.logを確認できます。たとえば、以下のように設定を変更します。

services:
  wordpress:
    volumes:
      - ./wp-content:/var/www/html/wp-content

これにより、./wp-content/debug.logでホスト側からログを確認できるようになります。

「php.ini」の設定で、WordPressのアップロード制限やメモリ使用量を設定する方法

1）docker-compose.ymlの環境変数で設定

version: '3.8'

services:
  wordpress:
    image: wordpress:latest
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: user
      WORDPRESS_DB_PASSWORD: password
      WORDPRESS_DB_NAME: wordpress
      PHP_UPLOAD_MAX_FILESIZE: 128M
      PHP_POST_MAX_SIZE: 128M
      PHP_MEMORY_LIMIT: 128M

2）カスタムPHP設定ファイルをマウントする方法

php.iniを作成

upload_max_filesize = 128M
post_max_size = 128M
memory_limit = 128M

docker-compose.yml でマウント設定

services:
  wordpress:
    image: wordpress:latest
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: user
      WORDPRESS_DB_PASSWORD: password
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./wordpress_data:/var/www/html
      - ./php.ini:/usr/local/etc/php/conf.d/custom.ini

必要最小限のファイル監視で、更新読み込みの速度を最大化

テーマファイルの内容をブラウザで確認する際、リロードに時間がかかる問題を解消できます！

実際に開発・編集するファイルのみをマウントすることで、Docker内部のファイル監視システムの負荷を最小限に抑え、更新時間を大幅に短縮できます。

https://yoshi-2210.hatenablog.com/entry/2022/04/09/102840#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E3%82%92%E7%A2%BA%E8%AA%8D%E3%81%97%E3%81%A6WordPress%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%99%E3%82%8B

WP本体インストールをドキュメントルート直下ではなく、別のサブディレクトリでしたい場合（複雑）

docker-compose.yml

services:
  wordpress:
    image: wordpress:6.4-php8.1
    restart: always
    ports:
      - 8080:80
    volumes:
      - ./:/var/www/html
      - ./docker-entrypoint.sh:/usr/local/bin/docker-entrypoint.sh
    working_dir: /var/www/html/wp
    environment:
      - WORDPRESS_DB_HOST=db
      - WORDPRESS_DB_USER=wordpress
      - WORDPRESS_DB_PASSWORD=wordpress
      - WORDPRESS_DB_NAME=wordpress
      - WORDPRESS_CONFIG_EXTRA=
        define('WP_HOME', 'http://localhost:8080');
        define('WP_SITEURL', 'http://localhost:8080/wp');

  db:
    image: mysql:8.0
    restart: always
    environment:
      - MYSQL_DATABASE=wordpress
      - MYSQL_USER=wordpress
      - MYSQL_PASSWORD=wordpress
      - MYSQL_ROOT_PASSWORD=somewordpress
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

working_dirでコンテナ内での作業ディレクトリを指定

working_dirはコンテナ内での作業ディレクトリを指定する設定です。コンテナ内でコマンドを実行する際の基準となります。

volumes: /var/local/wordpress:/var/www/html/wp
working_dir: /var/www/html/wp

この状態でdocker-compose upでイメージからコンテナのを新規作成をすると

– コンテナ内の /var/www/html/wp にファイルを展開

– volumesマウントにより、ホスト側の /var/local/wp にも同じファイルが表示される

docker-entrypoint.shでindex.php と .htaccessの設定

.sh ファイル（シェルスクリプト）とは

.sh ファイル（シェルスクリプト）は、Unix系システム（LinuxやmacOSなど）でコマンドを自動化するために記述されるスクリプトファイルです。

公式docker-entrypoint.shリポジトリのファイル下部を追記

公式docker-entrypoint.shリポジトリ
https://github.com/docker-library/wordpress/blob/master/docker-entrypoint.sh

...
			fi
		done
	fi
fi

#　↓ 追記部分 ↓

if [ -e /var/www/html/wp/index.php ] && [ -e /var/www/html/wp/.htaccess ] && [ ! -e /var/www/html/index.php ] && [ ! -e /var/www/html/.htaccess ]; then
    sed -i -e 's/\/wp-blog-header\.php/\/wp\/wp-blog-header.php/g' /var/www/html/wp/index.php
    mv /var/www/html/wp/.htaccess /var/www/html/.htaccess
    mv /var/www/html/wp/index.php /var/www/html/index.php
fi

# ↑ 追記部分 ↑

exec "$@"

ファイルの確認
- wpディレクトリにindex.phpが存在
- wpディレクトリに.htaccessが存在
- ルートにindex.phpが存在しない
- ルートに.htaccessが存在しない
index.phpの中のパス参照を修正
index.phpと.htaccessをwpディレクトリからルートに移動

参考サイト

WordPress on DockerでWP自体をサブディレクトリにインストールし、index.phpと.htaccessを自動で移動＆書き換えする
https://note.com/kezzytak/n/n4f9ac97466f2

M4 MacはARM64

# =============================================================
# WordPress テーマローカル開発環境
# =============================================================
# 使い方:
#   1. このファイルと同階層に themes/ ディレクトリを作成
#   2. themes/ 配下にテーマディレクトリを作成して開発
#   3. docker compose up -d で起動
#   4. http://localhost:8080 でアクセス
#
# ディレクトリ構成:
#   wp-maria11/
#   ├── docker-compose.yml
#   └── themes/
#       ├── theme-a/
#       │   └── style.css, functions.php, ...
#       └── theme-b/
#           └── ...
# =============================================================

services:
  db:
    # MariaDB を使用（MySQL 8.x は ARM64 非対応のため）
    # M4 Mac (ARM64) でネイティブ動作し、WordPress との互換性も問題なし
    image: mariadb:11
    volumes:
      - db_data:/var/lib/mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: somewordpress
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
    # ヘルスチェック: DB の起動完了を WordPress コンテナが待機できるようにする
    # depends_on だけではコンテナの起動順序しか保証されず、
    # DB が接続可能になる前に WordPress が起動して接続エラーになることがある
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5

  wordpress:
    depends_on:
      db:
        # service_healthy: DB のヘルスチェックが通るまで起動を待つ
        condition: service_healthy
    image: wordpress:latest
    ports:
      - "8080:80"
    restart: always
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      # WordPress 本体は名前付きボリュームで永続化
      # コンテナ内のファイルをそのまま使うため、アップデートなどが安全に行える
      - wp_data:/var/www/html

      # テーマディレクトリをホストからバインドマウント
      # ホスト側の ./themes/ を編集すると即座にコンテナ内に反映される
      #
      # 注意: この方法だと WordPress 標準テーマ（Twenty Twenty-Four 等）は
      #       ホスト側の ./themes/ に存在しないため管理画面から見えなくなる。
      #       標準テーマが必要なら、コンテナ初回起動後に
      #       docker compose cp wordpress:/var/www/html/wp-content/themes/ ./themes/
      #       でコピーしておくこと。
      - ./themes:/var/www/html/wp-content/themes

    # --- 権限の問題を解決 ---
    # WordPress コンテナ内の Apache は www-data (UID 33) で動作する。
    # ホスト側で作成したファイルはホストユーザーの UID で所有されるため、
    # コンテナ内から書き込めない場合がある（テーマの有効化、カスタマイザー保存等）。
    #
    # 以下の user 指定により、WordPress プロセスが root 権限で起動するため
    # マウントされたファイルの所有者に関係なく読み書きできる。
    # ローカル開発環境限定の設定であり、本番環境では絶対に使わないこと。
    user: "0:0"

volumes:
  db_data:   # MySQL データの永続化
  wp_data:   # WordPress 本体ファイルの永続化

DB接続について

ワードプレステーマ開発でそこまでDBを確認しながら進めることは不要かと思うので、コンテナ内でのみ確認できるようしています

メリットとしてはdocker-compose.ymlでDBのポートをホスト側に公開（ports）していないので、3306はDockerの内部ネットワークだけで使われています。ホスト側の3306と競合しません。

DBの内容を確認したい場合は下記の通りです

docker compose exec db mariadb -uwordpress -pwordpress wordpress
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 59
Server version: 11.8.6-MariaDB-ubu2404 mariadb.org binary distribution

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MariaDB [wordpress]> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| wordpress          |
+--------------------+
2 rows in set (0.001 sec)

MariaDB [wordpress]>