メインコンテンツまでスキップ

スターターキット

はじめに​

新しい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 "stack" は 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 ファイル内で定義されています。

注記

アプリケーションの 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は、Next、Nuxtなどによって動作するモダンなJavaScriptアプリケーションを認証する準備が整った認証APIをスキャフォールドすることもできます。開始するには、breeze:install Artisanコマンドを実行する際に、希望するスタックとしてAPIスタックを選択してください：

php artisan breeze:install

php artisan migrate

インストール中、Breezeはアプリケーションの.envファイルにFRONTEND_URL環境変数を追加します。このURLは、JavaScriptアプリケーションのURLである必要があります。通常、これはローカル開発中にhttp://localhost:3000になります。さらに、APP_URLがserve Artisanコマンドで使用されるデフォルトのURLであるhttp://localhost:8000に設定されていることを確認する必要があります。

Next.js 参照実装​

最後に、このバックエンドをお好みのフロントエンドとペアにする準備が整いました。Breeze フロントエンドの Next 参照実装は GitHub で利用可能です。このフロントエンドは Laravel によってメンテナンスされており、Breeze が提供する従来の Blade および Inertia スタックと同じユーザーインターフェースを含んでいます。

Laravel Jetstream​

Laravel Breeze は Laravel アプリケーションを構築するためのシンプルで最小限のスタート地点を提供しますが、Jetstream はその機能をより堅牢な機能と追加のフロントエンド技術スタックで補完します。Laravel に初めて触れる方には、Laravel Breeze で基礎を学んでから Laravel Jetstream に進むことをお勧めします。

Jetstream は、Laravel 用に美しくデザインされたアプリケーションの骨組みを提供し、ログイン、登録、メール認証、2要素認証、セッション管理、Laravel Sanctum を介した API サポート、オプションのチーム管理を含んでいます。Jetstream は Tailwind CSS を使用して設計されており、Livewire または Inertia ドリブンのフロントエンド骨組みを選択できます。

Laravel Jetstream のインストールに関する完全なドキュメントは、公式 Jetstream ドキュメント 内で見つけることができます。