イントロダクション
新しいLaravelアプリケーションの構築をすぐに取りかかれるようするため、認証とアプリケーションのスターターキットを提供しています。これらのキットはアプリケーションのユーザーを登録および認証するために必要なルート、コントローラ、ビューを自動的にスカフォールドします。
皆さんがこうしたスターターキットを使用してくれるのは大歓迎ですが、これらは必須でありません。Laravelの真新しいコピーをインストールするだけで、自分自身のアプリケーションを自由にゼロから構築できます。いずれにせよ、みなさんが素晴らしいものを作り上げるのはわかっています!
Laravel Breeze
Laravel Breezeへログイン、ユーザー登録、パスワードのリセット、メールの検証、パスワードの確認など、Laravelのすべての認証機能を最小限シンプルに実装しました。Laravel Breezeのデフォルトビュー層は、Tailwind CSSでスタイルを設定したシンプルなBladeテンプレートで構成しています。
Breezeは、新しいLaravelアプリケーションを始めるための素晴らしい出発点となり、BladeテンプレートをLaravel Livewireを使用し、レベルを上げる計画をしているプロジェクトにも最適な選択肢です。
インストール
まず、新しいLaravelアプリケーションを作成し、データベースを設定後、データベースのマイグレーションを実行する必要があります。
curl -s https://laravel.build/example-app | bash
cd example-app
php artisan migrate
新しいLaravelアプリケーションを作成したら、Composerを使用してLaravel Breezeをインストールします。
composer require laravel/breeze --dev
ComposerでLaravel
Breezeパッケージをインストールしたら、breeze:install
Artisanコマンドを実行します。このコマンドは、認証ビュー、ルート、コントローラ、およびその他のリソースをアプリケーションにリソース公開します。Laravel
Breezeは、その機能と実装を完全に制御し目に見えるようにするために、すべてのコードをアプリケーションへリソース公開します。Breezeをインストールしたら、アプリケーションのCSSファイルを使用できるようにアセットをコンパイルする必要もあります。
php artisan breeze:install
npm install
npm run dev
php artisan migrate
次に、Webブラウザでアプリケーションの/login
または/register
のURLにアクセスしてください。Breezeのすべてのルートは、`routes/auth.php'ファイル内に定義しています。
Tip!! アプリケーションのCSSとJavaScriptのコンパイルの詳細は、Laravel Mixドキュメントをご覧ください。
BreezeとReact/Vue
Laravel Breezeは、ReactとVueのスカフォールドをInertia.jsフロントエンド実装で提供しています。Inertiaを使用すると、古典的なサーバサイドのルーティングとコントローラを使用して、モダンなシングルページのReactとVueのアプリケーションを構築することができます。
Inertiaにより、ReactとVueのフロントエンドのパワーと、Laravelの素晴らしいバックエンドの生産性のコンビネーションが楽しめます。Inertiaスタックを使用するには、breeze:install
Artisanコマンドを実行し、使用するスタックとしてvue
、またはreact
を指定してください。
php artisan breeze:install vue
# もしくは
php artisan breeze:install react
npm install
npm run dev
php artisan migrate
BreezeのInertia
SSRのscaffoldサポートを使う場合は、breeze:install
コマンドを実行時に、ssr
オプションを指定してください。
php artisan breeze:install vue --ssr
php artisan breeze:install react --ssr
BreezeとNext.js/API
Laravel Breezeは、NextやNuxtなどのモダンなJavaScriptアプリケーションで認証するAPIをスカフォールドすることもできます。使い始めるには、breeze:install
Artisanコマンドを実行する時、api
スタックを希望するスタックとして指定します。
php artisan breeze:install api
php artisan migrate
インストール中、Breezeはアプリケーションの.env
ファイルへ、FRONTEND_URL
環境変数を追加します。このURLは、JavaScriptアプリケーションのURLである必要があります。ローカル開発では、これは通常http://localhost:3000
になります。さらに、APP_URL
をhttp://localhost:8000
に設定する必要があります。これは、serve
Artisanコマンドで使用されるデフォルトのURLです。
Next.jsリファレンス実装
ついに、このバックエンドとお好みのフロントエンドを組み合わせる準備ができました。BreezeフロントエンドのNextリファレンス実装はGitHubで公開しています。このフロントエンドはLaravelがメンテナンスし、Breezeが提供する従来のBladeスタックやInertiaスタックと同じユーザーインターフェイスを備えています。
Laravel Jetstream
Laravel Breezeは、Laravelアプリケーションを構築するためのシンプルで最小限の開始点を提供しますが、Jetstreamはより堅牢な機能と、追加のフロントエンドテクノロジースタックで、その機能を強化します。Laravelを初めて使用する場合は、Laravel Jetstreamへ進む前に、Laravel Breezeで勘所を掴むことをおすめします。
Jetstreamは、Laravelに美しく設計されたアプリケーションのスカフォールドを提供し、ログイン、ユーザー登録、メール検証、2要素認証、セッション管理、Laravel Sanctumを介したAPIサポート、およびオプションとしてチーム管理機能を含みます。JetstreamはTailwindCSSを使用して設計されており、Livewire(日本語)もしくはInertia.js駆動のフロントエンドスカフォールドから選択できます。
Laravel Jetstreamをインストールするための完全なドキュメントは、公式Jetstreamドキュメントにあります。