Starter Kits
Table of Contents
Introduction
新しい Laravel application の構築をスタートさせるために、私たちは authentication や application のスターターキットを提供しています。これらのキットは、あなたの application に必要な routes 、コントローラー、そして register やアプリケーションの users を認証するための views を自動的に組み立てます。
これらのスターターキットを使うことは自由ですが、 required ではありません。あなたは新しい Laravel のコピーをインストールするだけで、自由に build し、自分の application を一から作ることができます。どちらにしても、素晴らしいものを build すると私たちは確信しています！
Laravel Breeze
Laravel Breeze は、Laravel のすべてのauthentication 機能、log イン、登録、password reset、メール authentication、および password 確認の単純で簡単な実装です。さらに、Breeze には、user が自分の名前、メールアドレス、そして password を更新できるシンプルな「プロフィール」ページが含まれています。
Laravel Breeze の default view 層は、シンプルな Blade templatesで構成され、Tailwind CSS でスタイリングされています。また、Breeze は、Livewire またはInertia に基づくスキャフォールディング options を提供し、Inertia ベースのスキャフォールディングに Vue または React を選択できます。
Laravel Bootcamp
もし Laravel が初めての方なら、お気軽にLaravel Bootcamp に参加してみてください。 Laravel Bootcamp では、 Breeze を使用して初めての Laravel application を構築する方法を学べます。これは Laravel と Breeze が提供するすべてを一通り見て回るのに最適な方法です。
Installation
まず、新しい Laravel applicationを作成する必要があります。あなたがLaravel installerを使用して application を作成すると、インストール process 中に Laravel Breeze のインストールが求められます。それ以外の場合は、以下の手動インストールの指示に従う必要があります。
すでにスターターキットなしで新しい Laravel application を作成している場合、手動で Laravel Breeze を Composer を使用してインストールすることもできます：
composer require laravel/breeze --dev
Composer が Laravel Breeze パッケージをインストールした後、breeze:installという Artisan command を実行する必要があります。この command は、authenticationviewroutes、コントローラー、および他の resources をあなたの application にパブリッシュします。Laravel Breeze は、そのすべてのコードをあなたの application にパブリッシュし、その機能と実装について完全に制御と可視性を持つことができます。
breeze:install command は、あなたの好みのフロントエンド stack と testing フレームワークを prompt します:
php artisan breeze:install
php artisan migrate
npm install
npm run dev
Breeze と Blade
default の Breeze stack は、シンプルな“Blade テンプレートを使用して application のフロントエンドを rendering する Bladestack です。Bladestack は、他の追加引数なしでbreeze:install command を実行して Blade フロントエンド stack を選択することでインストールすることができます。Breeze のスキャフォールドがインストールされた後、application のフロントエンドアセットもコンパイルする必要があります。
php artisan breeze:install
php artisan migrate
npm install
npm run dev
次に、ご自身のアプリケーションの/loginまたは/register URL に、 web ブラウザで移動することができます。Breeze の全ての routes はroutes/auth.phpファイル内に定義されています。
NOTE
あなたのアプリケーションの CSS と JavaScript をコンパイルする詳細については、Laravel のVite ドキュメンテーションをご覧ください。
Breeze と Livewire
Laravel Breeze は、Livewire の設計を提供します。Livewire は、PHP だけを使用して動的で反応性のあるフロントエンドの UI を構築する強力な方法です。
Livewire は、主に Blade templates を使用するチームにとって最適であり、Vue や React のような JavaScript 駆動の SPA フレームワークに対するよりシンプルな代替手段を探している場合に役立つとされています。
Livewire の stack を使用するには、breeze:installの Artisan command を実行するときに Livewire のフロントエンド stack を select できます。Breeze のスキャフォールドがインストールされた後、あなたは database migrations を実行する必要があります。
php artisan breeze:install
php artisan migrate
Breeze と React / Vue
Laravel Breeze は、Inertia のフロントエンド実装を介して React と Vue のスケルトンを提供します。Inertia を使用すると、クラシックな servers サイドの routing とコントローラーを使用して、モダンなシングルページの React と Vueapplications を build することができます。
慣性は、React と Vue のフロントエンドの力と、すごいバックエンドの生産性を持つ Laravel 、そして稲妻のように速いVite のコンパイルを一緒に楽しむことができます。Inertia の stack を使用するには、breeze:installの Artisan command を実行するときに Vue または React フロントエンドスタックを select することができます。
Vue または React フロントエンドの stack を選択するとき、Breeze インストーラーは、Inertia SSR サポート、または TypeScript サポートを求めるかどうかを決定するように prompt します。 Breeze のスキャフォールディングがインストールされた後、application のフロントエンドアセットもコンパイルする必要があります：
php artisan breeze:install
php artisan migrate
npm install
npm run dev
次に、 web ブラウザーでアプリケーションの/loginまたは/registerの URL に移動できます。Breeze のすべての routes はroutes/auth.phpファイル内で定義されています。
Breeze と Next.js / API
Laravel Breeze は、Next やNuxt などで動作する現代的な JavaScriptapplications を authentication するための authenticationAPI も作成することができます。始めるには、breeze:installの Artisan command を実行するときに、希望の stack として API スタックを選択してください。
php artisan breeze:install
php artisan migrate
インストール中に、 Breeze はあなたの application の.envファイルにFRONTEND_URL environment variables を追加します。この default URL はあなたの JavaScript application の URL であるべきです。これは通常、ローカル development 中にはhttp://localhost:3000になります。また、あなたのAPP_URLがhttp://localhost:8000に設定されていることを確認するべきです。これはserve Artisan command によって使用される default URL です。
Next.js リファレンス実装
最後に、このバックエンドをお好みのフロントエンドとペアリングする準備が整いました。 Breeze フロントエンドの Next リファレンス実装は、GitHub で利用可能 です。このフロントエンドは Laravel によって保守されており、従来の Blade および Inertia スタックに提供される同じ user インターフェイスが含まれています。 Breeze によって提供されます。
Laravel Jetstream
Laravel Breeze は、Laravel アプリケーションを構築するためのシンプルで最小限のスタート地点を提供していますが、Jetstream はその機能をより強固な機能と追加のフロントエンド技術 stack で強化します。 Laravel にまったく新しい方々は、Laravel Jetstream に進む前に、まず Laravel Breeze で基本を学ぶことをお勧めします。
Jetstream は、見た目の美しい application スキャフォールドを Laravel に提供し、ログイン、登録、 email verification 、二要素 authentication 、 session 管理、 Laravel Sanctum を介した API サポート、およびオプションでのチーム管理を含みます。 Jetstream は Tailwind CSS を使用して設計されており、Livewire または Inertia のフロントエンドスキャフォールドを選択することができます。
Laravel Jetstream のインストールに関する完全なドキュメンテーションは、公式 Jetstream ドキュメンテーション 内にあります。