入门套件

• 介绍
• Laravel Breeze
  • 安装
  • Breeze and Blade
  • Breeze and Livewire
  • Breeze and React / Vue
  • Breeze and Next.js / API
• Laravel Jetstream

介绍

为了让您抢占先机，我们很乐意提供身份验证和应用程序初学者工具包。这些工具包会自动使用注册和验证应用程序用户所需的路由、控制器和视图来构建应用程序。

虽然欢迎您使用这些入门套件，但它们不是必需的。您可以自由地从头开始构建自己的应用程序，只需安装 Laravel 的全新副本即可。无论哪种方式，我们知道您都会做出伟大的贡献！

Laravel Breeze

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

Laravel Breeze 的默认视图层由使用 Tailwind CSS 设置样式的简单 Blade 模板组成。此外，Breeze 提供了基于 Livewire 或 Inertia 的脚手架选项，可以选择使用 Vue 或 React 进行基于 Inertia 的脚手架。

Laravel 训练营

如果您是 Laravel 的新手，请随时加入 Laravel 训练营。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 and Blade

默认的 Breeze“堆栈”是 Blade 堆栈，它利用简单的 Blade 模板来呈现应用程序的前端。可以通过调用 breeze:install 命令（不带其他附加参数）并选择 Blade 前端堆栈来安装 Blade 堆栈。安装 Breeze 的脚手架后，您还应该编译应用程序的前端资产:

php artisan breeze:install

php artisan migrate
npm install
npm run dev

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

NOTE

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

Breeze and Livewire

Laravel Breeze 还提供 Livewire 脚手架。Livewire 是一种仅使用 PHP 构建动态、反应式前端 UI 的强大方法。

Livewire 非常适合主要使用 Blade 模板并正在寻找更简单的替代方案来替代 JavaScript 驱动的 SPA 框架（如 Vue 和 React）的团队。

要使用 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 还可以搭建身份验证 API，该 API 已准备好对现代 JavaScript 应用程序进行身份验证，例如由 Next、Nuxt 等提供支持的应用程序。首先，在执行 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

最后，您已准备好将此后端与您选择的前端配对。GitHub 上提供了 Breeze 前端的下一个参考实现。此前端由 Laravel 维护，包含与 Breeze 提供的传统 Blade 和 Inertia 堆栈相同的用户界面。

Laravel Jetstream

虽然 Laravel Breeze 为构建 Laravel 应用程序提供了一个简单且最小的起点，但 Jetstream 通过更强大的功能和额外的前端技术堆栈增强了该功能。对于那些刚接触 Laravel 的人，我们建议您在毕业到 Laravel Jetstream 之前先与 Laravel Breeze 一起学习。

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

有关安装 Laravel Jetstream 的完整文档，请参阅官方 Jetstream 文档。