はじめに

この記事では、Laravel（バックエンド） と Next.js（フロントエンド） をDocker上で手軽に立ち上げる方法を紹介します。あらかじめ用意されたイメージとDocker Composeファイルを使うことで、5分ほどで開発を始められます。

前提条件

Docker および Docker Compose がインストール済みであること
Laravel と Next.js の基礎知識があること
コマンドライン操作に慣れていること

1. リポジトリをクローンする

まずは以下のコマンドで、リポジトリをローカル環境へクローンします。

git clone https://github.com/softjapan/laravel-nextjs-dev-environment.git

2. Laravel バックエンドの作成

次に、クローンしたディレクトリに移動して、Laravelバックエンドを作成します。
ここではデフォルトでMySQLが使われ、マイグレーションは後ほど行います。

cd laravel-nextjs-dev-environment
docker run --rm -it -v "$PWD:/app" softjpn/laravel-nodejs-dev laravel new laravel-backend

3. Laravel Breeze と依存パッケージのインストール

Laravel Breeze（APIスキャフォールド）をインストールします。この段階ではマイグレーションは実行しません。

cd laravel-backend
docker run --rm -it -v "$PWD:/app" softjpn/laravel-nodejs-dev composer require laravel/breeze --dev
docker run --rm -it -v "$PWD:/app" softjpn/laravel-nodejs-dev php artisan breeze:install api

4. Next.js フロントエンドの作成

Laravel BreezeのNext.js版をクローンしてフロントエンドとして利用します。

cd ..
docker run --rm -it -v "$PWD:/app" softjpn/laravel-nodejs-dev git clone https://github.com/laravel/breeze-next.git next-frontend

5. フロントエンドの依存パッケージをインストール

Next.js側の依存パッケージをインストールします。

cd next-frontend
docker run --rm -it -v "$PWD:/app" softjpn/laravel-nodejs-dev npm install

6. 環境変数ファイルの設定

.env ファイルをLaravelとNext.js用にコピーします。
各種データベース接続などの情報が記載されているため、必要に応じて編集してください。

cd ..
cp ./envfiles/laravel-backend/.env ./laravel-backend/.env
cp ./envfiles/next-frontend/.env ./next-frontend/.env

7. Dockerコンテナの起動

準備が整ったら、Docker Composeを使ってコンテナを立ち上げます。

docker compose up -d

8. データベースマイグレーション

コンテナが稼働し、.envファイルが正しく設定されていることを確認したら、マイグレーションを実行します。

docker exec -it laravel-backend php artisan migrate

9. フロントエンドにアクセス

ブラウザを開いて、以下のURLにアクセスしてください。

http://localhost:3000

ログイン画面やトップページが表示されればOKです。

10. Dockerコンテナを停止する

開発を終了する際は、以下のコマンドでコンテナを停止・削除できます。

docker compose down

スクリーンショット

本リポジトリには、実行時のイメージとして以下のようなスクリーンショットが含まれています。

まとめ

これで、LaravelとNext.jsのDocker開発環境を素早く構築できます。
詳細なコードや環境変数の設定、その他のカスタマイズなどはリポジトリを参考にしてください。

GitHub: softjapan/laravel-nextjs-dev-environment

License

本プロジェクトは MIT License のもとで公開されています。

Contributing

バグ報告や機能追加の提案などは、Pull RequestやIssueでお気軽にご連絡ください。

お問い合わせ

不明点や追加のサポートが必要な場合は、リポジトリのIssueにてお知らせください。

ぜひ、この環境を活用してLaravel + Next.jsの開発をスピーディに始めてみてください！