Mac + Docker Desktopで始めるLaravel開発環境構築（Sail + Breeze + phpMyAdmin対応）

はじめに

Laravelの新規プロジェクトを作る手順でハマったので、自分用のメモとして残しておく。

1.作業フォルダを用意

cd ~/work  # 好きな場所でOK

2.Laravelプロジェクトを作成（Sail対応）

curl -s "https://laravel.build/myapp" | bash
cd myapp

myapp は任意の名前でOK
この時点で docker-compose.yml が生成され、Sail用のDocker設定も含まれる

3.Sail を起動（Dockerコンテナ立ち上げ）

./vendor/bin/sail up -d

Docker Desktop が動作していることを確認
ブラウザで http://localhost にアクセス
Laravel のトップページが表示されるはず

⚠ DB接続エラーが出た場合は次のステップで対応

4.DBマイグレーション

DBがまだ初期化されていない場合、または Illuminate\Database\QueryException が出た場合はマイグレーションを実行します。

./vendor/bin/sail php artisan migrate

sessions テーブルやユーザーテーブルも作成され、Breezeのログイン/登録機能も動作可能

5.Breeze をインストール（認証機能追加）

./vendor/bin/sail composer require laravel/breeze --dev
./vendor/bin/sail php artisan breeze:install

UI の選択肢で Blade を選ぶのが初心者向き

フロントエンドのビルド：

./vendor/bin/sail npm install
./vendor/bin/sail npm run dev

6.phpMyAdmin を追加

プロジェクト直下の docker-compose.yml を開きます
mysql セクションの下あたりに phpMyAdmin の設定を追記

    phpmyadmin:
        image: phpmyadmin/phpmyadmin
        links:
            - mysql:mysql
        ports:
            - 8080:80
        environment:
            MYSQL_USERNAME: '${DB_USERNAME}'
            MYSQL_ROOT_PASSWORD: '${DB_PASSWORD}'
            PMA_HOST: mysql
        networks:
            - sail

Sail を再起動

./vendor/bin/sail down
./vendor/bin/sail up -d

7.phpMyAdmin にアクセス

ブラウザで確認

▼ログイン情報
ユーザー名: sail
パスワード: password
（.env の DB_USERNAME / DB_PASSWORD と同じ）

これでデータベースの確認・編集・SQL実行が可能

8.開発環境の全体像

Mac（ホスト）
└─ Docker Desktop
└─ Laravel Sail（コンテナ群）
├─ MySQL
├─ Nginx + PHP
├─ Redis（必要なら）
└─ phpMyAdmin

9.使用ツールと役割まとめ

ツール	役割
Docker	開発環境の箱
Sail	Laravel用Docker操作ツール
Laravel	Webアプリ本体
Breeze	ログイン/登録などの認証機能
phpMyAdmin	MySQLをブラウザで操作する管理画面

10.簡易フロー

1. フォルダ作成 → Laravelプロジェクト作成
2. Sail 起動 → localhost にアクセス
3. DBエラーが出たら → php artisan migrate
4. Breeze インストール → Blade選択 → npm ビルド
5. phpMyAdmin 追加 → docker-compose.yml編集 → Sail再起動
6. ブラウザで phpMyAdmin にアクセス

💡これで Mac + Docker + Sail + Breeze + phpMyAdmin の環境が完全に整い、
Breezeでのログイン/登録や DB 管理もブラウザから簡単にできる状態になります。