認証機能の導入（Laravel Breeze）

本記事では、管理画面用にLaravel標準の認証機能を導入する手順をまとめます。
今回はLaravel Breeze（Blade + Alpine）を使用し、ログイン・ユーザー登録機能を追加します。

---

前提

• Laravel12 + PHP8.4のDocker環境構築メモの手順でローカル環境を作成済み

---

① Laravel Breezeのインストール

まずはLaravel Breezeをインストールします。

docker compose exec app composer require laravel/breeze --dev
docker compose exec app php artisan breeze:install

インストール中に、いくつかの選択肢が表示されます。
今回は、以下の設定を選択しました。

設定選択

• Which Breeze stack would you like to install?
  → Blade with Alpine
• Would you like dark mode support?
  → Yes
• Which testing framework do you prefer?
  → PHPUnit

---

② Node.js専用コンテナを追加する

今回は、appコンテナにNode.jsを直接インストールせず、Node.js専用のコンテナを用意する構成とします。

②-1. docker-compose.ymlにnodeサービスを追加

docker-compose.ymlに以下を追記します。

  node:
    image: node:20
    container_name: laravel-node
    volumes:
      - ./src:/var/www/html
    working_dir: /var/www/html

②-2. コンテナを再起動

設定を反映させるため、コンテナを再起動します。

docker compose up -d

---

③ nodeコンテナでnpmを実行

nodeコンテナ上で、依存関係のインストールとビルドを行います。

docker compose run --rm node npm install
docker compose run --rm node npm run build

正常に完了すると、Viteのビルド成果物がpublic/buildディレクトリに生成されます。

---

動作確認

以下の URL にアクセスし、画面が表示されることを確認します。

• http://localhost:8080/login
• http://localhost:8080/register

ユーザー登録やログインが出来たら、認証機能の導入は完了です。

---

まとめ

• Laravel Breezeを使うことで、認証機能を簡単に導入できる。

---