スターターキット¶
はじめに¶
新しいLaravelアプリケーションの構築をスムーズに始められるように、認証とアプリケーションのスターターキットを提供しています。これらのキットは、アプリケーションのユーザーを登録し認証するために必要なルート、コントローラ、ビューを自動的にスキャフォールディングします。
これらのスターターキットを使用することは歓迎されますが、必須ではありません。新しいLaravelのコピーをインストールするだけで、アプリケーションを一から構築することも自由です。どちらの方法でも、素晴らしいものを作ることができることを知っています！
Laravel Breeze¶
Laravel Breezeは、Laravelのすべての認証機能を含む最小限かつシンプルな実装です。ログイン、登録、パスワードリセット、メール検証、パスワード確認などが含まれます。さらに、Breezeにはユーザーが名前、メールアドレス、パスワードを更新できるシンプルな「プロフィール」ページが含まれています。
Laravel Breezeのデフォルトのビューレイヤーは、Tailwind CSSでスタイルされたシンプルなBladeテンプレートで構成されています。さらに、BreezeはLivewireまたはInertiaに基づくスキャフォールディングオプションを提供し、InertiaベースのスキャフォールディングにはVueまたはReactを選択できます。
Laravel Bootcamp¶
Laravelを初めて使う方は、Laravel Bootcampに飛び込んでみてください。Laravel Bootcampでは、Breezeを使って最初のLaravelアプリケーションを構築する手順を説明します。LaravelとBreezeが提供するすべての機能を体験するのに最適な方法です。
インストール¶
まず、新しいLaravelアプリケーションを作成する必要があります。Laravelインストーラを使用してアプリケーションを作成する場合、インストールプロセス中にLaravel Breezeのインストールを促されます。そうでない場合は、以下の手動インストール手順に従う必要があります。
すでにスターターキットなしで新しいLaravelアプリケーションを作成している場合は、Composerを使用してLaravel Breezeを手動でインストールできます：
ComposerがLaravel Breezeパッケージをインストールした後、breeze:install Artisanコマンドを実行する必要があります。このコマンドは、認証ビュー、ルート、コントローラ、その他のリソースをアプリケーションに公開します。Laravel Breezeはすべてのコードをアプリケーションに公開するため、その機能と実装を完全に制御し、可視化することができます。
breeze:installコマンドは、お好みのフロントエンドスタックとテストフレームワークを尋ねます：
BreezeとBlade¶
デフォルトのBreeze「スタック」はBladeスタックで、シンプルなBladeテンプレートを使用してアプリケーションのフロントエンドをレンダリングします。Bladeスタックは、追加の引数なしでbreeze:installコマンドを実行し、Bladeフロントエンドスタックを選択することでインストールできます。Breezeのスキャフォールディングがインストールされた後、アプリケーションのフロントエンドアセットもコンパイルする必要があります：
次に、アプリケーションの/loginまたは/registerURLにブラウザでアクセスできます。Breezeのすべてのルートはroutes/auth.phpファイル内で定義されています。
Note
アプリケーションのCSSとJavaScriptをコンパイルする方法について詳しく知りたい場合は、LaravelのViteドキュメントを確認してください。
BreezeとLivewire¶
Laravel Breezeは、Livewireスキャフォールディングも提供します。Livewireは、PHPのみを使用して動的でリアクティブなフロントエンドUIを構築する強力な方法です。
Livewireは、主にBladeテンプレートを使用し、VueやReactのようなJavaScript駆動のSPAフレームワークの代わりにシンプルな選択肢を探しているチームにとって最適です。
Livewireスタックを使用するには、breeze:install Artisanコマンドを実行する際にLivewireフロントエンドスタックを選択します。Breezeのスキャフォールディングがインストールされた後、データベースマイグレーションを実行する必要があります：
BreezeとReact / Vue¶
Laravel Breezeは、Inertiaフロントエンド実装を介してReactとVueのスキャフォールディングも提供します。Inertiaを使用すると、クラシックなサーバーサイドルーティングとコントローラを使用して、モダンなシングルページのReactとVueアプリケーションを構築できます。
Inertiaを使用すると、ReactとVueのフロントエンドの力と、Laravelのバックエンドの生産性とViteのコンパイル速度を組み合わせることができます。Inertiaスタックを使用するには、breeze:install Artisanコマンドを実行する際にVueまたはReactフロントエンドスタックを選択します。
VueまたはReactフロントエンドスタックを選択すると、BreezeインストーラーはInertia SSRまたはTypeScriptサポートを希望するかどうかも尋ねます。Breezeのスキャフォールディングがインストールされた後、アプリケーションのフロントエンドアセットもコンパイルする必要があります：
次に、アプリケーションの/loginまたは/registerURLにブラウザでアクセスできます。Breezeのすべてのルートはroutes/auth.phpファイル内で定義されています。
BreezeとNext.js / API¶
Laravel Breezeは、Next、NuxtなどのモダンなJavaScriptアプリケーションを認証するための認証APIのスキャフォールディングも提供します。始めるには、breeze:install Artisanコマンドを実行する際にAPIスタックを希望するスタックとして選択します：
インストール中、Breezeはアプリケーションの.envファイルにFRONTEND_URL環境変数を追加します。このURLは、JavaScriptアプリケーションのURLである必要があります。これは通常、ローカル開発中はhttp://localhost:3000です。さらに、APP_URLがhttp://localhost:8000に設定されていることを確認してください。これは、serve Artisanコマンドで使用されるデフォルトのURLです。
Next.jsリファレンス実装¶
最後に、このバックエンドを選択したフロントエンドとペアリングする準備が整いました。BreezeフロントエンドのNext.jsリファレンス実装は、GitHubで利用可能です。このフロントエンドはLaravelによってメンテナンスされており、Breezeが提供する従来のBladeとInertiaスタックと同じユーザーインターフェースを含んでいます。
Laravel Jetstream¶
Laravel Breezeは、Laravelアプリケーションを構築するためのシンプルで最小限の出発点を提供しますが、Jetstreamはその機能をより堅牢な機能と追加のフロントエンド技術スタックで強化します。Laravelを初めて使用する方には、Laravel Jetstreamに進む前にLaravel Breezeで基本を学ぶことをお勧めします。
Jetstreamは、Laravelのために美しく設計されたアプリケーションスキャフォールディングを提供し、ログイン、登録、メール検証、二要素認証、セッション管理、Laravel SanctumによるAPIサポート、およびオプションのチーム管理を含みます。JetstreamはTailwind CSSを使用して設計され、LivewireまたはInertia駆動のフロントエンドスキャフォールディングを選択できます。
Laravel Jetstreamのインストールに関する完全なドキュメントは、公式Jetstreamドキュメントにあります。