0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

CakePHPを使った環境構築と、システム構築についてのメモ

0
Last updated at Posted at 2026-02-24

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

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?