Starter Kits
Introduction
新しい Laravel アプリケーションの構築をすぐに始められるように、認証およびアプリケーションのスターター キットを喜んで提供します。これらのキットは、アプリケーションのユーザーを登録および認証するために必要なルート、コントローラ、ビューを使用してアプリケーションを自動的にスキャフォールディングします。
これらのスターター キットを使用しても構いませんが、必須ではありません。 Laravel の新しいコピーをインストールするだけで、独自のアプリケーションを最初から自由に構築できます。いずれにせよ、私たちはあなたが素晴らしいものを作り上げることを確信しています。
Laravel Breeze
Laravel Breeze は、ログイン、登録、パスワードのリセット、メール検証、パスワードの確認を含む、Laravel の authentication features のすべてを最小限にシンプルに実装したものです。さらに、Breeze には、ユーザーが自分の名前、電子メール アドレス、パスワードを更新できる簡単な「プロフィール」ページが含まれています。
Laravel Breezeのデフォルトのビューレイヤーは、シンプルな Blade templates で構成されており、Tailwind CSS でスタイル設定されています。さらに、Breeze は、Livewire または Inertia に基づくスキャフォールディング オプションを提供し、Inertiaベースのスキャフォールディングに Vue または React を使用することを選択できます。
Laravel Bootcamp
Laravel を初めて使用する場合は、お気軽に Laravel Bootcamp にアクセスしてください。 Laravel Bootcamp では、Breeze を使用して最初の Laravel アプリケーションを構築する手順を説明します。これは、Laravel と Breeze が提供するすべての機能を見学するのに最適な方法です。
Installation
まず、create a new Laravel application を実行する必要があります。 Laravel installer を使用してアプリケーションを作成する場合、インストールプロセス中に 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 and Blade
Breeze のデフォルトの「スタック」は Blade スタックで、単純な Blade templates を利用してアプリケーションのフロントエンドをレンダリングします。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 ファイル内で定義されます。
アプリケーションの CSS と JavaScript のコンパイルの詳細については、Laravel の Vite documentation を確認してください。
Breeze and 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 and 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 and Next.js / API
Laravel Breeze は、Next、Nuxt などを利用した最新の JavaScript アプリケーションを認証する準備ができている認証 API をスキャフォールディングすることもできます。まず、breeze:install Artisan コマンドを実行するときに、目的のスタックとして API スタックを選択します。
php artisan breeze:install
php artisan migrate
インストール中に、Breeze は FRONTEND_URL 環境変数をアプリケーションの .env ファイルに追加します。この URL は、JavaScript アプリケーションの URL である必要があります。通常、ローカル開発中は http://localhost:3000 になります。さらに、APP_URL が http://localhost:8000 に設定されていることを確認する必要があります。これは、serve Artisan コマンドで使用されるデフォルトの URL です。
Next.js Reference Implementation
最後に、このバックエンドを選択したフロントエンドと組み合わせる準備が整いました。 Breeze フロントエンドの Next リファレンス実装は、available on GitHub です。このフロントエンドは Laravel によって保守されており、Breeze によって提供される従来の Blade および Inertia スタックと同じユーザー インターフェイスが含まれています。
Laravel Jetstream
Laravel Breeze は Laravel アプリケーションを構築するためのシンプルかつ最小限の開始点を提供しますが、Jetstream はより堅牢な機能と追加のフロントエンド テクノロジ スタックでその機能を強化します。 Laravel を初めて使用する方は、Laravel Jetstream を卒業する前に、Laravel Breeze でコツを学ぶことをお勧めします。
Jetstream は、Laravel 用に美しく設計されたアプリケーション スキャフォールディングを提供します。これには、ログイン、登録、電子メール検証、2 要素認証、セッション管理、Laravel Sanctum を介した API サポート、およびオプションのチーム管理が含まれます。 Jetstream は Tailwind CSS を使用して設計されており、Livewire または Inertia 駆動のフロントエンド スキャフォールディングを選択できます。
Laravel Jetstream のインストールに関する完全なドキュメントは、official Jetstream documentation 内にあります。