简介

为了让您在构建新的 Laravel 应用程序时能够快速起步，我们很高兴为您提供认证和应用程序入门套件。这些套件会自动为您的应用程序搭建所需的路由、控制器和视图，以注册和认证您应用程序的用户。

虽然您可以使用这些入门套件，但这并不是必需的。您可以通过简单地安装一个全新的 Laravel 副本，从基础开始构建自己的应用程序。无论哪种方式，我们相信您都会构建出出色的东西！

Laravel Breeze

Laravel Breeze (opens in a new tab) 是对 Laravel 的所有认证功能的一种最小化、简单的实现，包括登录、注册、密码重置、电子邮件验证和密码确认。此外，Breeze 还包括一个简单的“个人资料”页面，用户可以在其中更新他们的姓名、电子邮件地址和密码。

Laravel Breeze 的默认视图层由使用Tailwind CSS (opens in a new tab) 样式的简单Blade 模板组成。此外，Breeze 提供了基于Livewire (opens in a new tab) 或 Inertia (opens in a new tab) 的搭建选项，对于基于 Inertia 的搭建，可以选择使用 Vue 或 React。

Laravel 训练营

如果您是 Laravel 的新手，欢迎加入Laravel 训练营 (opens in a new tab)。Laravel 训练营将引导您使用 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“栈”是 Blade 栈，它使用简单的Blade 模板来渲染应用程序的前端。可以通过调用breeze:install命令且不添加其他额外参数，并选择 Blade 前端栈来安装 Blade 栈。在安装好 Breeze 的脚手架后，您还应该编译应用程序的前端资源：

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

接下来，您可以在网络浏览器中导航到应用程序的/login或/register URL。Breeze 的所有路由都在routes/auth.php文件中定义。

[!NOTE]
要了解更多关于编译应用程序的 CSS 和 JavaScript 的信息，请查看 Laravel 的Vite 文档。

Breeze 和 Livewire

Laravel Breeze 还提供了Livewire (opens in a new tab)脚手架。Livewire 是一种仅使用 PHP 构建动态、响应式前端 UI 的强大方式。

对于主要使用 Blade 模板并正在寻找比像 Vue 和 React 这样的 JavaScript 驱动的 SPA 框架更简单的替代方案的团队来说，Livewire 是一个很好的选择。

要使用 Livewire 栈，在执行breeze:install Artisan 命令时，可以选择 Livewire 前端栈。在安装好 Breeze 的脚手架后，您应该运行数据库迁移：

php artisan breeze:install
 
php artisan migrate

Breeze 和 React / Vue

Laravel Breeze 还通过Inertia (opens in a new tab)前端实现提供了 React 和 Vue 脚手架。Inertia 允许您使用经典的服务器端路由和控制器来构建现代的单页 React 和 Vue 应用程序。

Inertia 使您能够享受 React 和 Vue 的前端功能，同时结合 Laravel 的惊人后端生产力和快速的Vite (opens in a new tab)编译。要使用 Inertia 栈，在执行breeze:install Artisan 命令时，可以选择 Vue 或 React 前端栈。

当选择 Vue 或 React 前端栈时，Breeze 安装程序还会提示您确定是否需要Inertia SSR (opens in a new tab)或 TypeScript 支持。在安装好 Breeze 的脚手架后，您还应该编译应用程序的前端资源：

php artisan breeze:install
 
php artisan migrate
npm install
npm run dev

接下来，您可以在网络浏览器中导航到应用程序的/login或/register URL。Breeze 的所有路由都在routes/auth.php文件中定义。

Breeze 和 Next.js / API

Laravel Breeze 还可以搭建一个认证 API，该 API 可用于对现代 JavaScript 应用程序进行认证，例如由 Next (opens in a new tab)、Nuxt (opens in a new tab) 等驱动的应用程序。要开始使用，在执行 breeze:install Artisan 命令时，选择 API 堆栈作为您所需的堆栈：

php artisan breeze:install
 
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 上获取 (opens in a new tab)。此前端由 Laravel 维护，并包含与 Breeze 提供的传统 Blade 和 Inertia 堆栈相同的用户界面。

Laravel Jetstream

虽然 Laravel Breeze 为构建 Laravel 应用程序提供了一个简单且最小化的起点，但 Jetstream 通过更强大的功能和额外的前端技术堆栈增强了该功能。对于那些刚接触 Laravel 的人，我们建议先使用 Laravel Breeze 熟悉基础知识，然后再升级到 Laravel Jetstream。

Jetstream 为 Laravel 提供了一个设计精美的应用程序脚手架，包括登录、注册、电子邮件验证、双因素认证、会话管理、通过 Laravel Sanctum 实现的 API 支持以及可选的团队管理。Jetstream 使用 Tailwind CSS (opens in a new tab) 进行设计，并提供您选择的 Livewire (opens in a new tab) 或 Inertia (opens in a new tab) 驱动的前端脚手架。

有关安装 Laravel Jetstream 的完整文档可以在 官方 Jetstream 文档 (opens in a new tab) 中找到。