このリポジトリはLaravel開発環境をDockerで簡単に構築できるテンプレートです。
特徴
- 即座に開発開始:
docker compose up -d一発でLaravel環境が立ち上がる - フル機能: phpMyAdmin、MailHogが標準装備
- 自動セットアップ: 初回起動時にLaravelプロジェクトを自動作成
- メールテスト: 送信メールをブラウザで確認可能
| サービス | 説明 | ポート | URL |
|---|---|---|---|
| PHP/Apache | Laravel実行環境 + Composer | 8080 | localhost:8080 |
| MariaDB | リレーショナルデータベース | 3306 | - |
| phpMyAdmin | データベース管理ツール | 8081 | localhost:8081 |
| MailHog | メール送受信テストツール | 8025 | localhost:8025 |
- Docker (Docker Desktop または Docker Engine)
- Windows の場合: Hyper-V または WSL2
Warning
WindowsではHyper-VとWSL2のどちらか一方がセットアップされている必要があります。
git clone https://github.com/saitogo555/docker-laravel-dev.git
cd docker-laravel-devdocker compose up -dLaravel アプリケーション: http://localhost:8080
phpMyAdmin: http://localhost:8081
MailHog: http://localhost:8025
初回起動時、src フォルダが空の場合、最新のLaravelプロジェクトが自動でセットアップされます。
方法1: コンテナ内で実行
docker compose exec php bash
php artisan migrate
composer install方法2: ホストから直接実行
docker compose exec php php artisan migrate
docker compose exec php composer installコンテナ起動時に以下の優先順位で .env ファイルを自動生成:
.env.local(最優先).env.example
メール設定はMailHog用に自動で設定されます:
MAIL_MAILER=smtp
MAIL_HOST=mailhog
MAIL_PORT=1025
MAIL_FROM_ADDRESS="admin@example.com".env ファイルに以下を設定:
DB_CONNECTION=mysql
DB_HOST=mariadb
DB_PORT=3306
DB_DATABASE=laravel_app
DB_USERNAME=root
DB_PASSWORD=root# MariaDBコンテナに入る
docker compose exec mariadb bash
# データベースにログイン
mariadb -u root -p laravel_app
# パスワード: rootアクセス: http://localhost:8081
ログイン情報
- ユーザー:
root - パスワード:
root
アクセス: http://localhost:8025
PHPから送信されたメールは全てMailHogで受信され、ブラウザで確認できます。
docker-laravel-dev/
├── php/
│ ├── dockerfile
│ ├── entrypoint.sh
│ ├── php.ini
│ └── 000-default.conf
├── src/ # Laravelプロジェクト
├── compose.yml # Docker Compose設定
└── README.md
| 操作 | コマンド |
|---|---|
| コンテナ起動 | docker compose up -d |
| コンテナ停止 | docker compose down |
| コンテナ再起動 | docker compose restart |
| ログ確認 | docker compose logs -f |
| PHPコンテナに入る | docker compose exec php bash |
| MariaDBコンテナに入る | docker compose exec mariadb bash |
| 完全クリーンアップ | docker compose down -v --rmi all |
| サービス | URL | 説明 |
|---|---|---|
| Laravel | http://localhost:8080 | メインアプリケーション |
| phpMyAdmin | http://localhost:8081 | データベース管理 |
| MailHog | http://localhost:8025 | メール確認 |