コンテンツへスキップ

スターターキット

はじめに

新しい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 require laravel/breeze --dev

ComposerがLaravel Breezeパッケージをインストールしたら、breeze:install Artisanコマンドを実行する必要があります。このコマンドは、認証ビュー、ルート、コントローラー、およびその他のリソースをアプリケーションに公開します。Laravel Breezeは、そのコードをすべてアプリケーションに公開するため、その機能と実装を完全に制御および可視化できます。

breeze:installコマンドは、優先するフロントエンドスタックとテストフレームワークを尋ねます

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

BreezeとBlade

デフォルトのBreeze「スタック」は、アプリケーションのフロントエンドをレンダリングするためにシンプルなBladeテンプレートを利用するBladeスタックです。Bladeスタックは、他の追加引数なしでbreeze:installコマンドを呼び出し、Bladeフロントエンドスタックを選択することでインストールできます。Breezeのスキャフォールディングがインストールされたら、アプリケーションのフロントエンドアセットもコンパイルする必要があります

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

次に、Webブラウザーでアプリケーションの/loginまたは/register URLに移動できます。Breezeのすべてのルートは、routes/auth.phpファイル内で定義されています。

lightbulb

アプリケーションのCSSとJavaScriptのコンパイルの詳細については、LaravelのViteドキュメントを参照してください。

BreezeとLivewire

Laravel Breezeは、Livewireスキャフォールディングも提供します。Livewireは、PHPのみを使用して動的なリアクティブフロントエンドUIを構築する強力な方法です。

Livewireは、主にBladeテンプレートを使用し、VueやReactのようなJavaScript駆動のSPAフレームワークに代わるよりシンプルなものを探しているチームに最適です。

Livewireスタックを使用するには、breeze:install Artisanコマンドを実行するときにLivewireフロントエンドスタックを選択できます。Breezeのスキャフォールディングがインストールされたら、データベースのマイグレーションを実行する必要があります

php artisan breeze:install
 
php artisan migrate

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のスキャフォールディングがインストールされたら、アプリケーションのフロントエンドアセットもコンパイルする必要があります

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

次に、Webブラウザーでアプリケーションの/loginまたは/register URLに移動できます。Breezeのすべてのルートは、routes/auth.phpファイル内で定義されています。

BreezeとNext.js / API

Laravel Breezeは、NextNuxtなどで動作する最新のJavaScriptアプリケーションを認証する準備ができている認証APIをスキャフォールディングすることもできます。開始するには、breeze:install Artisanコマンドを実行するときに、目的のスタックとしてAPIスタックを選択します

php artisan breeze:install
 
php artisan migrate

インストール中、Breezeはアプリケーションの.envファイルにFRONTEND_URL環境変数を追加します。このURLは、JavaScriptアプリケーションのURLである必要があります。これは通常、ローカル開発中はhttps://:3000になります。さらに、APP_URLhttps://: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用の美しくデザインされたアプリケーションスキャフォールディングを提供し、ログイン、登録、メール認証、二要素認証、セッション管理、Laravel SanctumによるAPIサポート、オプションのチーム管理が含まれています。JetstreamはTailwind CSSを使用して設計されており、LivewireまたはInertia駆動のフロントエンドスキャフォールディングを選択できます。

Laravel Jetstreamのインストールに関する完全なドキュメントは、公式Jetstreamドキュメントにあります。