# Laravel Breeze 認証導入ガイド（日本語）

# Laravel Breeze 認証導入ガイド（日本語） このドキュメントは、Laravel プロジェクトに Breeze 認証を導入するための手順を整理したものです。 ## 1. Breeze とは Laravel Breeze は、Laravel 公式の軽量な認証スターターキットです。以下の機能を素早く導入できます。 - ログイン - ユーザー登録 - パスワード再設定 - メール認証（有効化時） - プロファイル編集（構成による） ## 2. 前提条件 - PHP 8.0 以上（Laravel バージョン要件に準拠） - Composer - Node.js / npm - DB 接続設定済み（MySQL, PostgreSQL, SQLite など） ## 3. 新規 Laravel プロジェクトへ導入 ### 3.1 Laravel 作成 ```bash composer create-project laravel/laravel my-app cd my-app ``` ### 3.2 環境変数設定 `.env` の DB 設定を行います。 例（SQLite の場合）: ```dotenv DB_CONNECTION=sqlite DB_DATABASE=/absolute/path/to/database.sqlite ``` SQLite を使う場合、必要なら DB ファイルを作成します。 ```bash touch database/database.sqlite ``` ### 3.3 Breeze をインストール ```bash composer require laravel/breeze --dev php artisan breeze:install ``` フロントエンドスタックを明示する場合の例: ```bash php artisan breeze:install blade ``` ### 3.4 フロントエンド依存をインストールしてビルド ```bash npm install npm run build ``` 開発中は次でも可: ```bash npm run dev ``` ### 3.5 マイグレーション実行 ```bash php artisan migrate ``` ### 3.6 起動・確認 ```bash php artisan serve ``` ブラウザで以下を確認: - `/login` - `/register` ## 4. 既存 Laravel プロジェクトへ導入 既存プロジェクトでも基本は同じです。 ```bash composer require laravel/breeze --dev php artisan breeze:install blade npm install npm run build php artisan migrate ``` ## 5. ルートと認証の基本確認 導入後に主に追加されるもの: - `routes/auth.php`（ログイン、登録、パスワード再設定など） - 認証関連 Controller / Request / View - `resources/views/auth/*` - `resources/views/layouts/*` 認証保護したい画面は `auth` ミドルウェアで保護します。 ```php Route::middleware('auth')->group(function () { Route::get('/dashboard', function () { return view('dashboard'); })->name('dashboard'); }); ``` ## 6. よく使うカスタマイズ ### 6.1 登録を無効化したい - `routes/auth.php` から register 関連ルートを削除 - ナビゲーション上の登録リンクを削除 ### 6.2 ログイン可能ユーザーを制限したい - `LoginRequest` をカスタマイズ - 追加ミドルウェアで許可ユーザーを制御 ### 6.3 画面文言を日本語化したい - `lang/ja` を用意 - Blade テンプレートの固定文言を日本語に変更 ## 7. トラブルシューティング ### 7.1 `Vite manifest not found` エラー フロントエンドをビルドしていない可能性があります。 ```bash npm install npm run build ``` ### 7.2 CSS が反映されない - `npm run build` を再実行 - ブラウザキャッシュをクリア ### 7.3 `Target class ... does not exist` - クラス名・名前空間・`use` 文を確認 - 変数名が Laravel 内部変数と衝突していないか確認 ## 8. 導入コマンドまとめ ```bash composer require laravel/breeze --dev php artisan breeze:install blade npm install npm run build php artisan migrate php artisan serve ``` ---