CakePHPを使った環境構築(Docker/MySQL)と、システム構築についてのメモ
Windows + Docker で CakePHP 5 + MySQL の開発環境を構築する
はじめに
本記事では、Windows 環境で Docker を使い、CakePHP 5 と MySQL の開発環境をゼロから構築する手順をまとめます。Composer によるプロジェクト作成、docker-compose でのコンテナ構成、DB 接続設定、マイグレーションと bake による CRUD 生成まで、コマンドとファイル内容を具体的に記載しています。
対象読者
- Windows で開発している方
- Docker Desktop を利用できる方
- CakePHP 5 で Web アプリを始めたい方
この記事で構築する環境
| 項目 | 内容 |
|---|---|
| OS | Windows 10/11 |
| Web/App | CakePHP 5.3, PHP 8.2, Apache |
| DB | MySQL 8.0(Docker) |
| 構成 | docker-compose(app + db の 2 コンテナ) |
前提条件
- Docker Desktop for Windows がインストールされ、WSL2 または Hyper-V で動作していること
- ターミナルは PowerShell を想定(コマンドはそのままコピーして利用可能)
1. プロジェクトフォルダの作成
作業用ディレクトリと、Docker 用・CakePHP 用のフォルダを用意します。
cd C:\Users\ABC
mkdir cakephp-docker
cd cakephp-docker
mkdir php-apache
mkdir app
ディレクトリ構成は次のとおりです。
cakephp-docker/
├── docker-compose.yml # 後で作成
├── php-apache/
│ └── Dockerfile # 後で作成
└── app/ # ここに CakePHP をインストール(初回は空)
2. docker-compose.yml の作成
プロジェクトルート(cakephp-docker)に docker-compose.yml を作成します。
version: "3.9"
services:
app:
build: ./php-apache
container_name: cake_app
ports:
- "8080:80"
volumes:
- ./app:/var/www/html
depends_on:
- db
db:
image: mysql:8.0
container_name: cake_db
environment:
MYSQL_ROOT_PASSWORD: rootpwd
MYSQL_DATABASE: cake_app
MYSQL_USER: cake_user
MYSQL_PASSWORD: cake_pwd
ports:
- "3306:3306"
volumes:
- db_data:/var/lib/mysql
volumes:
db_data:
- app: PHP 8.2 + Apache で CakePHP を動かすコンテナ。ポート 8080 で公開。
-
db: MySQL 8.0。DB 名
cake_app、ユーザーcake_user、パスワードcake_pwdで自動作成されます。
3. PHP + Apache 用 Dockerfile の作成
php-apache/Dockerfile を作成し、CakePHP に必要な拡張と Apache 設定を行います。
FROM php:8.2-apache
# 必要なパッケージと PHP 拡張をインストール
RUN apt-get update && apt-get install -y \
git \
unzip \
libicu-dev \
libonig-dev \
libzip-dev \
&& docker-php-ext-install intl mbstring pdo_mysql zip \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists/*
# Apache の mod_rewrite を有効化
RUN a2enmod rewrite
# CakePHP 用に DocumentRoot を webroot に変更
ENV APACHE_DOCUMENT_ROOT=/var/www/html/webroot
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf /etc/apache2/apache2.conf
# Composer を導入
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
WORKDIR /var/www/html
- intl / mbstring / pdo_mysql / zip: CakePHP でよく使う拡張です。
-
DocumentRoot:
/var/www/html/webrootにし、CakePHP の公開ディレクトリとして扱います。
4. コンテナのビルドと起動
プロジェクトルートで以下を実行します。
cd C:\Users\ABC\cakephp-docker
docker compose up -d --build
初回はイメージのビルドに少し時間がかかります。完了後、次のコマンドでコンテナが動いていることを確認します。
docker ps
cake_app と cake_db が Up になっていれば OK です。
5. コンテナ内で CakePHP をインストール
app コンテナに入り、/var/www/html(=ホストの app フォルダ)に CakePHP プロジェクトを作成します。
docker exec -it cake_app bash
コンテナ内で次を実行します。
cd /var/www/html
composer create-project --prefer-dist cakephp/app:^5.3 .
インストール中に質問が出た場合は、基本的に Enter で進めて問題ありません。完了したらコンテナから抜けます。
exit
6. データベース接続の設定
CakePHP の DB 設定は config/app_local.php で行います。
ホスト側のパスでは C:\Users\ABC\cakephp-docker\app\config\app_local.php です。
'Datasources' => ['default' => ...] を、次のように編集します。ホスト名は Docker Compose のサービス名 db にします。
'Datasources' => [
'default' => [
'className' => \Cake\Database\Connection::class,
'driver' => \Cake\Database\Driver\Mysql::class,
'persistent' => false,
'host' => 'db',
'port' => 3306,
'username' => 'cake_user',
'password' => 'cake_pwd',
'database' => 'cake_app',
'encoding' => 'utf8mb4',
'timezone' => 'UTC',
'flags' => [],
'cacheMetadata' => true,
],
],
保存すると、ボリュームマウントによりコンテナ内にも反映されます。
7. マイグレーションと CRUD の生成(任意)
DB のテーブル作成と、bake による CRUD 生成まで行う場合の手順です。
再度コンテナに入ります。
docker exec -it cake_app bash
cd /var/www/html
マイグレーションの実行
bin/cake migrations migrate
例: articles テーブルを作成
bin/cake bake migration CreateArticles title:string body:text published:boolean created modified
bin/cake migrations migrate
articles の CRUD を一括生成
bin/cake bake all articles
これで ArticlesController、ArticlesTable、Entity、および templates/Articles/ 以下のビューが自動作成されます。完了したら exit でコンテナを抜けてください。
8. 動作確認
ブラウザで次の URL にアクセスします。
| 内容 | URL |
|---|---|
| CakePHP トップ(ウェルカムページ) | http://localhost:8080 |
| articles 一覧(bake 実行後) | http://localhost:8080/articles |
トップページが表示され、下部に DB 接続状況が出ていれば設定は問題ありません。/articles で一覧・新規作成・編集ができれば、環境構築は完了です。
よく使う Docker コマンド
# 起動
docker compose up -d
# 停止
docker compose down
# アプリコンテナのシェルに入る
docker exec -it cake_app bash
まとめ
- Windows で Docker を使い、CakePHP 5 + MySQL の開発環境を構築する手順をまとめました。
-
docker-composeで app(PHP/Apache)と db(MySQL)の 2 コンテナを定義し、appに CakePHP を Composer でインストールする構成です。 -
config/app_local.phpのホスト名はdb(サービス名)にすること、DocumentRoot を webroot にすることがポイントです。
同じ手順を Linux や macOS で行う場合は、パスの区切りや docker exec の使い方だけ読み替えれば、そのまま応用できると思います。
参考リンク
タグ(Qiita 用)
CakePHP Docker MySQL Windows docker-compose PHP