启动套件

• 介绍
• Laravel Breeze
  • 安装
  • Breeze 与 Inertia
  • Breeze 与 Next.js / API
• Laravel Jetstream

介绍

为了帮助您快速构建新的 Laravel 应用程序，我们很高兴提供身份验证和应用程序启动套件。这些套件会自动为您的应用程序生成所需的路由、控制器和视图，以便注册和验证应用程序用户。

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

Laravel Breeze

Laravel Breeze 是对 Laravel 所有身份验证功能的一个简单、极简的实现，包括登录、注册、密码重置、电子邮件验证和密码确认。Laravel Breeze 的默认视图层由简单的 Blade 模板组成，并使用 Tailwind CSS 进行样式设计。

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:1.9.2

Composer 安装 Laravel Breeze 包后，您可以运行 breeze:install Artisan 命令。此命令会将身份验证视图、路由、控制器和其他资源发布到您的应用程序中。Laravel Breeze 会将其所有代码发布到您的应用程序中，以便您可以完全控制和查看其功能和实现。在安装 Breeze 后，您还应该编译您的资产，以便应用程序的 CSS 文件可用：

php artisan breeze:install

npm install
npm run dev
php artisan migrate

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

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

Breeze 与 Inertia

Laravel Breeze 还提供了一个由 Vue 或 React 驱动的 Inertia.js 前端实现。要使用 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 与 Next.js / API

Laravel Breeze 还可以为现代 JavaScript 应用程序（如由 Next、Nuxt 等驱动的应用程序）生成一个准备好进行身份验证的 API。要开始，请在执行 breeze:install Artisan 命令时指定 api 堆栈：

php artisan breeze:install api

php artisan migrate

在安装过程中，Breeze 会将一个 FRONTEND_URL 环境变量添加到应用程序的 .env 文件中。此 URL 应为 JavaScript 应用程序的 URL。在本地开发期间，这通常是 http://localhost:3000。

Next.js 参考实现

最后，您可以准备好将此后端与您选择的前端配对。Breeze 前端的 Next 参考实现可在 GitHub 上找到。此前端由 Laravel 维护，并包含与 Breeze 提供的传统 Blade 和 Inertia 堆栈相同的用户界面。

Laravel Jetstream

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

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

有关安装 Laravel Jetstream 的完整文档可以在 官方 Jetstream 文档 中找到。