イントロダクションIntroduction
新しいLaravelアプリケーションの構築をすぐに取りかかれるようするため、認証とアプリケーションのスターターキットを提供しています。これらのキットはアプリケーションのユーザーを登録および認証するために必要なルート、コントローラ、ビューを自動的にスカフォールドします。To give you a head start building your new Laravel application, we are happy to offer authentication and application starter kits. These kits automatically scaffold your application with the routes, controllers, and views you need to register and authenticate your application's users.
皆さんがこうしたスターターキットを使用してくれるのは大歓迎ですが、これらは必須でありません。Laravelの真新しいコピーをインストールするだけで、自分自身のアプリケーションを自由にゼロから構築できます。いずれにせよ、みなさんが素晴らしいものを作り上げるのはわかっています！While you are welcome to use these starter kits, they are not required. You are free to build your own application from the ground up by simply installing a fresh copy of Laravel. Either way, we know you will build something great!
Laravel BreezeLaravel Breeze
Laravel Breezeへログイン、ユーザー登録、パスワードのリセット、メールの検証、パスワードの確認など、Laravelのすべての認証機能を最小限シンプルに実装しました。Laravel Breezeのデフォルトビュー層は、Tailwind CSSでスタイルを設定したシンプルなBladeテンプレートで構成しています。Laravel Breeze[https://github.com/laravel/breeze] is a minimal, simple implementation of all of Laravel's authentication features[/docs/{{version}}/authentication], including login, registration, password reset, email verification, and password confirmation. Laravel Breeze's default view layer is made up of simple Blade templates[/docs/{{version}}/blade] styled with Tailwind CSS[https://tailwindcss.com].
Breezeは、新しいLaravelアプリケーションを始めるための素晴らしい出発点となり、BladeテンプレートをLaravel Livewireを使用し、レベルを上げる計画をしているプロジェクトにも最適な選択肢です。Breeze provides a wonderful starting point for beginning a fresh Laravel application and is also great choice for projects that plan to take their Blade templates to the next level with Laravel Livewire[https://laravel-livewire.com].
インストールInstallation
まず、新しいLaravelアプリケーションを作成し、データベースを設定後、データベースのマイグレーションを実行する必要があります。First, you should create a new Laravel application[/docs/{{version}}/installation], configure your database, and run your database migrations[/docs/{{version}}/migrations]:
curl -s https://laravel.build/example-app | bash
cd example-app
php artisan migrate
新しいLaravelアプリケーションを作成したら、Composerを使用してLaravel Breezeをインストールします。Once you have created a new Laravel application, you may install Laravel Breeze using Composer:
composer require laravel/breeze --dev
ComposerでLaravel Breezeパッケージをインストールしたら、breeze:install Artisanコマンドを実行します。このコマンドは、認証ビュー、ルート、コントローラ、およびその他のリソースをアプリケーションにリソース公開します。Laravel Breezeは、その機能と実装を完全に制御し目に見えるようにするために、すべてのコードをアプリケーションへリソース公開します。Breezeをインストールしたら、アプリケーションのCSSファイルを使用できるようにアセットをコンパイルする必要もあります。After Composer has installed the Laravel Breeze package, you may run the breeze:install Artisan command. This command publishes the authentication views, routes, controllers, and other resources to your application. Laravel Breeze publishes all of its code to your application so that you have full control and visibility over its features and implementation. After Breeze is installed, you should also compile your assets so that your application's CSS file is available:
php artisan breeze:install
npm install
npm run dev
php artisan migrate
次に、Webブラウザでアプリケーションの/loginまたは/registerのURLにアクセスしてください。Breezeのすべてのルートは、`routes/auth.php'ファイル内に定義しています。Next, you may navigate to your application's /login or /register URLs in your web browser. All of Breeze's routes are defined within the routes/auth.php file.
">Tip!! アプリケーションのCSSとJavaScriptのコンパイルの詳細は、Laravel Mixドキュメントをご覧ください。{tip} To learn more about compiling your application's CSS and JavaScript, check out the Laravel Mix documentation[/docs/{{version}}/mix#running-mix].
BreezeとInertiaBreeze & Inertia
Laravel Breezeでは、VueやReactを使ったInertia.jsのフロントエンド実装も提供しています。Inertiaスタックを使用するには、breeze:install Artisanコマンドを実行する際に、希望するスタックとしてvueまたはreactを指定します。Laravel Breeze also offers an Inertia.js[https://inertiajs.com] frontend implementation powered by Vue or React. To use an Inertia stack, specify vue or react as your desired stack when executing the breeze:install Artisan command:
php artisan breeze:install vue
// もしくは…
php artisan breeze:install react
npm install
npm run dev
php artisan migrate
BreezeとNext.js／APIBreeze & Next.js / API
Laravel Breezeは、NextやNuxtなどのモダンなJavaScriptアプリケーションで認証するAPIをスカフォールドすることもできます。使い始めるには、breeze:install Artisanコマンドを実行する時、apiスタックを希望するスタックとして指定します。Laravel Breeze can also scaffold an authentication API that is ready to authenticate modern JavaScript applications such as those powered by Next[https://nextjs.org], Nuxt[https://nuxtjs.org], and others. To get started, specify the api stack as your desired stack when executing the breeze:install Artisan command:
php artisan breeze:install api
php artisan migrate
インストール時に、Breezeはアプリケーションの.envファイルへ環境変数FRONTEND_URLを追加します。このURLは、あなたのJavaScriptアプリケーションのURLでなければなりません。ローカル開発時、通常はhttp://localhost:3000となります。During installation, Breeze will add a FRONTEND_URL environment variable to your application's .env file. This URL should be the URL of your JavaScript application. This will typically be http://localhost:3000 during local development.
Next.jsリファレンス実装Next.js Reference Implementation
ついに、このバックエンドとお好みのフロントエンドを組み合わせる準備ができました。BreezeフロントエンドのNextリファレンス実装はGitHubで公開しています。このフロントエンドはLaravelがメンテナンスし、Breezeが提供する従来のBladeスタックやInertiaスタックと同じユーザーインターフェイスを備えています。Finally, you are ready to pair this backend with the frontend of your choice. A Next reference implementation of the Breeze frontend is available on GitHub[https://github.com/laravel/breeze-next]. This frontend is maintained by Laravel and contains the same user interface as the traditional Blade and Inertia stacks provided by Breeze.
Laravel JetstreamLaravel Jetstream
Laravel Breezeは、Laravelアプリケーションを構築するためのシンプルで最小限の開始点を提供しますが、Jetstreamはより堅牢な機能と、追加のフロントエンドテクノロジースタックで、その機能を強化します。Laravelを初めて使用する場合は、Laravel Jetstreamへ進む前に、Laravel Breezeで勘所を掴むことをおすめします。While Laravel Breeze provides a simple and minimal starting point for building a Laravel application, Jetstream augments that functionality with more robust features and additional frontend technology stacks. For those brand new to Laravel, we recommend learning the ropes with Laravel Breeze before graduating to Laravel Jetstream.
Jetstreamは、Laravelに美しく設計されたアプリケーションのスカフォールドを提供し、ログイン、ユーザー登録、メール検証、２要素認証、セッション管理、Laravel Sanctumを介したAPIサポート、およびオプションとしてチーム管理機能を含みます。JetstreamはTailwindCSSを使用して設計されており、Livewire（日本語）もしくはInertia.js駆動のフロントエンドスカフォールドから選択できます。Jetstream provides a beautifully designed application scaffolding for Laravel and includes login, registration, email verification, two-factor authentication, session management, API support via Laravel Sanctum, and optional team management. Jetstream is designed using Tailwind CSS[https://tailwindcss.com] and offers your choice of Livewire[https://laravel-livewire.com] or Inertia.js[https://inertiajs.com] driven frontend scaffolding.
Laravel Jetstreamをインストールするための完全なドキュメントは、公式Jetstreamドキュメント（和訳）にあります。Complete documentation for installing Laravel Jetstream can be found within the official Jetstream documentation[https://jetstream.laravel.com/2.x/introduction.html].