エンジニア日記

現役エンジニアの役に立てばいいなと思い立ち上げたブログ

Laravel Homesteadでの認証機能導入: Breezeパッケージの活用

※ 当ブログにはプロモーションが含まれています

はじめに

Laravelを学び始めたけど、ログイン機能ってどう作るの?と思ったことはありませんか?

この記事では、Laravel Homestead(仮想環境)を使っている方向けに、公式パッケージ「Breeze」を使って最短でログイン機能を導入する手順を紹介します。


対象読者

  • Laravel + Homestead 環境がセットアップ済み
  • 認証機能をすぐ試してみたい
  • Breezeの導入方法を知りたい

1. Laravel Homesteadとは?

Laravel Homesteadは、Laravel用に最適化された仮想マシンVagrantベース)です。

以下のメリットがあります:

  • OSやPHPバージョンを汚さずに開発可能
  • MySQL, Nginx, Redisなどが最初から入っている
  • 複数プロジェクトを仮想環境で管理可能

2. Breezeとは?

Laravel Breezeは、ログイン・登録・パスワードリセットなどを最小構成で提供する公式の認証テンプレートです。

  • Blade + Tailwind CSSベースでシンプル
  • 学習コストが低くカスタマイズしやすい
  • Laravel 8以降で利用可能

3. Breezeの導入手順(Homestead環境)

以下の手順をHomesteadのSSH内で実行してください。

# Laravelプロジェクトへ移動
cd ~/code/your-laravel-app

# Breezeインストール
composer require laravel/breeze --dev

# Breezeのセットアップ
php artisan breeze:install

# npmパッケージのインストールとビルド
npm install && npm run dev

# マイグレーション実行
php artisan migrate

4. 確認する

Homestead.yaml で設定したドメイン(例:http://laravel.test)にブラウザでアクセスします。

http://laravel.test/login

http://laravel.test/register

それぞれアクセスしてログイン・登録画面が表示されれば成功です!


5. BreezeのUI切り替え(任意)

以下のようにReact/Vue/API版も選べます。

php artisan breeze:install vue
php artisan breeze:install react
php artisan breeze:install api

6. よくあるエラー対策(Homestead編)

トラブル 対応
Laravelの画面が真っ白 php artisan migrate 忘れがちです
npm コマンドが動かない npmホストPC側で実行する(Homestead内ではなく)
.envにAPP_URLが間違っている http://laravel.testなどに修正

7. おすすめ書籍&動画教材

📗 Laravelの教科書 バージョン10対応

Laravelの教科書 バージョン10対応 [ 加藤 じゅんこ ]

価格:3300円
(2025/6/22 14:40時点)


まとめ

  • Homesteadでも簡単にLaravel Breezeを導入できる
  • ログイン・登録・パスワードリセットが自動で生成される
  • 開発を始める上でのスタート地点としておすすめ!

関連記事

👉 ブックマーク・読者登録もぜひお願いします!