Laravel 9.x スターターキット

イントロダクション

新しいLaravelアプリケーションの構築をすぐに取りかかれるようするため、認証とアプリケーションのスターターキットを提供しています。これらのキットはアプリケーションのユーザーを登録および認証するために必要なルート、コントローラ、ビューを自動的にスカフォールドします。

皆さんがこうしたスターターキットを使用してくれるのは大歓迎ですが、これらは必須でありません。Laravelの真新しいコピーをインストールするだけで、自分自身のアプリケーションを自由にゼロから構築できます。いずれにせよ、みなさんが素晴らしいものを作り上げるのはわかっています！

Laravel Breeze

Laravel Breezeへログイン、ユーザー登録、パスワードのリセット、メールの検証、パスワードの確認など、Laravelのすべての認証機能を最小限シンプルに実装しました。Laravel Breezeのデフォルトビュー層は、Tailwind CSSでスタイルを設定したシンプルなBladeテンプレートで構成しています。

Breezeは、新しいLaravelアプリケーションを始めるための素晴らしい出発点となり、BladeテンプレートをLaravel Livewireを使用し、レベルを上げる計画をしているプロジェクトにも最適な選択肢です。

インストール

まず、新しいLaravelアプリケーションを作成し、データベースを設定後、データベースのマイグレーションを実行する必要があります。

curl -s https://laravel.build/example-app | bash

cd example-app

php artisan migrate

新しいLaravelアプリケーションを作成したら、Composerを使用してLaravel Breezeをインストールします。

composer require laravel/breeze --dev

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

php artisan breeze:install

npm install
npm run dev
php artisan migrate

次に、Webブラウザでアプリケーションの/loginまたは/registerのURLにアクセスしてください。Breezeのすべてのルートは、`routes/auth.php'ファイル内に定義しています。

Tip!! アプリケーションのCSSとJavaScriptのコンパイルの詳細は、Laravel Mixドキュメントをご覧ください。

BreezeとReact／Vue

Laravel Breezeは、ReactとVueのスカフォールドをInertia.jsフロントエンド実装で提供しています。Inertiaを使用すると、古典的なサーバサイドのルーティングとコントローラを使用して、モダンなシングルページのReactとVueのアプリケーションを構築することができます。

Inertiaにより、ReactとVueのフロントエンドのパワーと、Laravelの素晴らしいバックエンドの生産性のコンビネーションが楽しめます。Inertiaスタックを使用するには、breeze:install Artisanコマンドを実行し、使用するスタックとしてvue、またはreactを指定してください。

php artisan breeze:install vue

# もしくは

php artisan breeze:install react

npm install
npm run dev
php artisan migrate

BreezeのInertia SSRのscaffoldサポートを使う場合は、breeze:installコマンドを実行時に、ssrオプションを指定してください。

php artisan breeze:install vue --ssr
php artisan breeze:install react --ssr

BreezeとNext.js／API

Laravel Breezeは、NextやNuxtなどのモダンなJavaScriptアプリケーションで認証するAPIをスカフォールドすることもできます。使い始めるには、breeze:install Artisanコマンドを実行する時、apiスタックを希望するスタックとして指定します。

php artisan breeze:install api

php artisan migrate

インストール中、Breezeはアプリケーションの.envファイルへ、FRONTEND_URL環境変数を追加します。このURLは、JavaScriptアプリケーションのURLである必要があります。ローカル開発では、これは通常http://localhost:3000になります。さらに、APP_URLをhttp://localhost: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はTailwindCSSを使用して設計されており、Livewire（日本語）もしくはInertia.js駆動のフロントエンドスカフォールドから選択できます。

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