この記事を読むと：

• 自由に触れるWordPress環境を構築できる
• Dockerによる環境構築方法を理解できる

なぜDockerなのか？

Dockerを使用してローカル開発環境を作るメリットは「動作環境をコード化して、どのPCでも同じ状態を再現できる」という点にあります。

実務上は以下のようなメリットになります。

• 本番環境に合わせた構成が簡単に作成できる
• 環境差分（PC環境ごとに動作が違う）を無くす
• 複数の構成が異なる環境を同時に起動できる

逆にデメリットはローカルで動かすためPCに負荷がかかる点です。
PCのスペックが低い、Docker側で重い作業を行う等でPCの動作が遅くなります。

前提条件・環境

今回の検証環境は以下です。

• Docker Desktop
• テキストエディタ（VSCodeなど）
• Webブラウザ（Chromeなど）
• コマンドプロンプト（macならターミナル）

Docker Desktopの導入方法は以下にて解説しておりますので、未導入の場合は是非参考にしてください。

ローカル開発環境構築のためのDocker Desktop導入手順

opticode.lab.com

ステップ1 Docker Desktopの起動

なにはともあれDocker Desktopを起動しましょう。起動すれば以下のような画面が表示されるはずです。

また、Windowsなら以下のようにタスクバーにも表示されているはずです。

ステップ2 Docker設定ファイルの作成

Dockerで環境を構築するためには docker-compose.yml という設定ファイルが必要になります。
このファイルにはコンテナ内に構築する環境の構成を記述し、それをもとにDockerが自動で環境を構築する仕組みになっています。

docker-compose.yml に記述する構成は本番環境と同様のものを指定しましょう。
本記事では複雑になりすぎないよう “ローカルにWordPress環境を作るための最小構成” で説明します。

作業用ディレクトの作成

まずは docker-compose.yml を置くフォルダを作成します。
場所やフォルダ名は何でもいいですが、WordPressのDBやテーマファイルもここに入るため作業しやすい場所がいいと思います。

今回は Cドライブ直下に test-site フォルダを作成することとしました。

docker-compose.yml ファイルの作成

テキストエディタを開き、以下の内容を記述したうえで docker-compose.yml というファイル名で保存し、作成した作業用ディレクトリに置きます。

services:
  db:
    image: mysql:8.4
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass
      MYSQL_ROOT_PASSWORD: rootpass
    volumes:
      - db_data:/var/lib/mysql

  wordpress:
    image: wordpress:6.9.1-php8.2-apache
    restart: unless-stopped
    depends_on:
      - db
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_NAME: wordpress
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
    volumes:
      - ./wp-content:/var/www/html/wp-content

volumes:
  db_data:

ひとつずつ解説します。

全体像

• services: の下に「起動するコンテナ（サービス）」を並べる
  今回は db: と wordpress: を起動しています。
• volumes: でデータを永続化するための領域を定義
  これがなければコンテナを停止した時にデータが消えちゃうので必須の記述です。

DB

db:
    image: mysql:8.4
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass
      MYSQL_ROOT_PASSWORD: rootpass
    volumes:
      - db_data:/var/lib/mysql

• db という名前のサービスの設定内容を記述
• image: mysql:8.4 MySQL 8.4 の公式イメージを指定する
• restart: unless-stopped コンテナが落ちた時に自動で再起動する（手動で停止させた場合を除く）
• environment:データベース名、ユーザー名とそのパスワード、rootユーザーのパスワードをそれぞれ指定する
• volumes:MySQLのデータ保存場所を指定する

WordPress

  wordpress:
    image: wordpress:6.9.1-php8.2-apache
    restart: unless-stopped
    depends_on:
      - db
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_NAME: wordpress
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
    volumes:
      - ./wp-content:/var/www/html/wp-content

• wordpressという名前のサービスの設定内容を記述
• image: wordpress:6.9.1-php8.2-apache WordPress 6.9.1 をPHP 8.2、WebサーバーはApacheを指定
• restart: unless-stopped DBと同様に落ちたら自動復帰
• depends_on: - db 先に記述したdbが起動した後にWordPressを起動するという指定
• ports:- "8080:80" ブラウザを使用し http://localhost:8080 でページを閲覧するためのポート設定
• environment:先に記述したDBをWordPressに使用させるための接続情報を指定
• volumes: コンテナ内の wp-content を、PC上の ./wp-content フォルダにマウントさせる設定

長くなりましたが、ひとまずこれで最低限WordPressを動かすための準備ができました。

ステップ3 コンテナの起動

コマンドプロンプト（またはターミナル）を使用してコンテナを起動します。
まずはコマンドプロンプトを起動し、docker-compose.yml を格納した作業用フォルダに移動します。

そこで以下のコマンドを実行してください。

docker compose up -d

これは docker-compose.yml の内容をもとにコンテナを作成するものです。
実行するとコンテナの初回起動が行われます。以下のような表示が出るはずです。

また、Docker Desktopを見ると以下のように起動中のコンテナが確認できるようになっています。

ステップ4 WordPressにアクセス

起動したWordPressにアクセスしましょう。
http://localhost:8080 でアクセスできるよう設定していたので、Webブラウザを使用してこのURLにアクセスしてみてください。
まっさらなWordPressが入っているので、以下のような言語設定の画面から始まると思います。日本語を選択して次へ進んでください。

サイトの基本情報を入力して、WordPressをインストールしてください。
ここで入力した内容は後ほどWordPressの管理画面から設定変更が可能なので、まだ決まって無ければとりあえずのものを入れておきましょう。

インストールが完了したらログイン画面に遷移するため、先ほど設定したユーザー名・パスワードでログインしてください。
無事ログインできればWordPressのダッシュボードが表示されるはずです。

ステップ5 コンテナの停止と保存確認

コンテナを停止した際に情報が消えてしまわないか確認します。
コマンドプロンプトにて、作業用ディレクトリへ移動し以下のコマンドを実行します。

docker compose down

これで再度 http://localhost:8080 にアクセスしてみてください。停止できていればアクセスできなくなっているはずです。
そのまま以下のコマンドを実行し、コンテナを起動してみましょう。

docker compose up -d

初回起動ほど待たずに起動されたかと思います。http://localhost:8080 にアクセスしましょう。
コンテナ停止で情報が消えてなければ、初回起動時のような言語設定・基本情報設定は表示されません。
http://localhost:8080/wp-login.php にアクセスしてログインしてみましょう。ユーザー情報も残っているためログインできます。

ステップ6 テーマ読み込み確認

ステップ2 にて wp-content フォルダのマウント設定を行っているため、作業フォルダ内の wp-content 内にあるファイルを変更すればローカル環境にもその内容が反映されます。

WordPress 6.9.1 ではデフォルトで twentytwentyfive のテーマが読み込まれているので、このテーマを編集して反映されるか確認してみましょう。

触るファイルは何でもいいですが、今回はわかりやすいように wp-content/themes/twentytwentyfive/patterns の header.php を使用してみます。

テキストエディタで header.php を開き、末尾に好きな文字列を入れて保存してみてください。
以下のようにサイトのヘッダーに記述した文字列が出ていれば成功です。

これでDockerを使用したWordPressローカル環境を作成することができました。

既に本番サイトが存在する場合はローカル環境にテーマファイルをアップロードしたり、投稿のインポート・エクスポート機能を用いて本番同様の環境にしてしまいましょう。

まとめ

今回はDockerを使用したWordPress開発環境の作り方を解説していきました。

コンテナは複数作ってもOKなのでサイトごとにどんどんコンテナを作っていきましょう。
また、チームで開発を行っている場合は同じ docker-compose.yml を共有することで環境差分を減らせます。

本来は本番環境の構成に合わせて設定を行うため、細かな設定は以下のリファレンスで確認してみましょう。

• Compose file reference（公式）
• Compose ファイル リファレンス（非公式）

この記事を読むと：

• Dockerの基礎知識が身につく
• チーム内での環境依存を減らした開発ができる

Dockerとは？

簡単に説明するなら、アプリを動かすのに必要なもの一式（実行環境）を「コンテナ」という箱にまとめて、どのPCでも同じように動かせる仕組みです。

コンテナ内にどんなアプリを入れるかは設定ファイルにて指定ができ、本番環境と同じ構成を指定すれば同様の構成をコンテナ内に再現できます。
その設定ファイルを開発チーム内で共有すれば、全員同じ環境で開発作業が行えるようになります。

またコンテナの作成・削除も容易なので、とりあえず触れるまっさらなWordPressを作る、というのにも最適です。

前提条件・環境

Docker Desktopを使用するには以下の要件を満たす必要があります。

• Windows 11 64 ビット: Home Pro Enterprise Education バージョン 21H2またはそれ以降 or
  macOS 10.15 またはそれ以降
• 4 GB 以上のシステム RAM
• BIOS 設定において BIOS レベルのハードウェア仮想化サポートが有効であること

そもそもWindows11が64bitのみで4GB RAMは必須なのでWindows11が入っているPCならほぼ大丈夫です。macもおそらく古すぎなければ大丈夫だと思われます。
記事ではWindows11 Proを使用しますが、macでも設定はほぼ同様と思われます。

ハードウェア仮想化サポートの有効確認

一番手軽なのが タスクマネージャ → パフォーマンス の 仮想化 という項目を見る方法です。
ここが「有効」になっていれば有効化されています。

無効の場合は以下2つの設定を確認する必要があります。

BIOSでの有効化

BIOSで仮想化が無効となっている場合があります。
BIOSの設定方法はPCごとに異なるため、以下のようなワードを検索してご自身でご確認ください。

• PC型番 仮想化
• PCメーカー名 仮想化
• マザーボード型番 仮想化
• マザーボードメーカー 仮想化

注意：BIOS設定ではデフォルトで有効 + 非表示 となっている場合アリ。設定項目が見当たらなければ先に「Windowsでの有効化」を試してみましょう。

Windowsでの有効化

Win + R → optionalfeatures → Enter（「Windows の機能」）

次にチェックを入れてOKを押し、PCを再起動する

• 仮想マシン プラットフォーム（Virtual Machine Platform）
• Linux 用 Windows サブシステム（Windows Subsystem for Linux）

再起動したらタスクマネージャーから仮想化が有効になっているかを確認しましょう。

導入手順

Windows11 Proでの手順となりますので、その他の環境では少々内容が異なることはあります。
設定項目の違いはあるものの、Windows11 Homeでも導入できることは確認済みです。

ステップ1 インストーラーのダウンロード

まずはDocker Desctop を入手しましょう。
Docker公式の Docker Desktop をダウンロードするから自分の環境にあった installerをダウンロードしてください。
Windowsは2種類ありますが基本的にはAMD64でOKです。ARM PCを使用している場合はARM64を選択してください。

ステップ2 インストーラーの実行

ダウンロードが終わったらinstallerを実行してDocker Desktopをインストールしてください。

注意：インストール中はPC再起動が発生するので作業中のデータがある場合は保存しておくことをおすすめします。

このアプリがデバイスに変更を加えることを許可しますか？という確認が表示されます。
「はい」でOKです。

以下の画面が表示されます。

Use WSL 2 instead of Hyper-V → チェックを入れる
Hyper-Vの代わりにWSL2を使用するかの確認
Allow Windows Containers to be used with this installation → チェック無し
Windowsアプリ用のコンテナもインストールするかの確認
Add shorcut to desktop → お好きに
デスクトップにショートカットを作成するかの確認

上記の通りチェックしたら右下の「OK」を押すとインストールが開始されます。
完了すると以下が表示されるので、「Close and restart」を押します。（ここでPCの再起動が発生します）

再起動が完了するとDocker Desktopが起動し、以下のような画面が表示されます。

使用許諾に関する内容で、以下のようなことが書いてあります。

サブスクリプションサービス契約、Dockerデータ処理契約、データプライバシーポリシー、およびDocker AI補足規約に同意したことになります。
従業員数250名以上、または年間売上高1,000万ドル以上の企業でDocker Desktopを商用利用するには、有料サブスクリプションが必要です。

確認のうえ、問題なければ「Accept」でOKです。

注意：記事作成時の内容なので念のためご自身でも内容をご確認ください。

ステップ3 WSL2 インストール

ここからWSL2のインストール状況によって分岐するようです。
WSL2とはWindows上でLinuxを動かすためのものです。Dockerを使用するために必要なものです。

管理人の場合は既にWSL2が入っていたようで、以下の確認が表示されました。
このアプリがデバイスに変更を加えることを許可しますか？ Linux用Windowsサブシステム
この場合は「はい」を選択してください。

上記のような画面が表示されます。任意のキーを押せば更新できます。

そもそもインストールされていなければインストールが必要となります。
その場合は以下を参考にインストールしてみてください。
WSL を使用して Windows に Linux をインストールする方法

ステップ4 動作確認

ステップ3 まで完了すると以下のようなDocker Desktopのウィンドウが表示されます。
SkipでOKです。

以下の状態になれば成功です。

これでPC上にDocker Desktopを使用する準備が整いました。

まとめ

今回はDocker Desktopの導入方法について解説しました。
なかなか手間のかかる設定ですが、Docker Desktopが使えると軽量かつ環境に依存せず開発が進められるため非常に便利です。

自分で好きにできる環境を試せるのはモチベに繋がるので、是非いろいろな環境を構築してみてください。