入门套件

• Introduction
• Laravel 微风
  • Installation
  • 微风与刀片
  • 微风 & 反应 / Vue
  • 微风 & Next.js / API
• Laravel 喷射流

#Introduction

为了让您抢先一步构建新的 Laravel 应用程序，我们很高兴提供身份验证和应用程序入门工具包。这些工具包会自动为您的应用程序搭建脚手架，其中包含您注册和验证应用程序用户所需的路由、控制器和视图。

虽然欢迎您使用这些入门工具包，但它们不是必需的。只需安装 Laravel 的全新副本，您就可以从头开始构建自己的应用程序。无论哪种方式，我们都知道您将构建伟大的东西！

#Laravel 微风

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

Laravel Breeze 的默认视图层由简单的刀片模板 风格与顺风 CSS.或者，Breeze 可以使用 Vue 或 React 构建您的应用程序，并且Inertia.

Breeze 为开始一个全新的 Laravel 应用程序提供了一个很好的起点，对于那些计划将他们的 Blade 模板提升到一个新水平的项目来说也是一个很好的选择Laravel Livewire.

Laravel 训练营

如果你是 Laravel 的新手，请随时跳入Laravel 训练营. Laravel 训练营将引导您使用 Breeze 构建您的第一个 Laravel 应用程序。这是浏览 Laravel 和 Breeze 所提供的一切的好方法。

#Installation

首先，你应该创建一个新的 Laravel 应用程序，配置你的数据库，然后运行你的数据库迁移.创建新的 Laravel 应用程序后，您可以使用 Composer 安装 Laravel Breeze：

composer require laravel/breeze --dev

安装 Breeze 后，您可以使用下面文档中讨论的 Breeze“堆栈”之一构建您的应用程序。

#微风与刀片

Composer 安装 Laravel Breeze 包后，你可以运行breeze:install 工匠命令。此命令将身份验证视图、路由、控制器和其他资源发布到您的应用程序。 Laravel Breeze 将其所有代码发布到您的应用程序，以便您可以完全控制和查看其功能和实现。

默认的 Breeze“堆栈”是 Blade 堆栈，它使用简单的刀片模板 呈现您的应用程序的前端。可以通过调用breeze:install 没有其他附加参数的命令。安装 Breeze 的脚手架后，您还应该编译应用程序的前端资产：

php artisan breeze:install

php artisan migrate
npm install
npm run dev

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

深色模式

如果您希望 Breeze 在构建应用程序前端时包含“暗模式”支持，只需提供--dark 执行指令时breeze:install 命令：

php artisan breeze:install --dark

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

#微风 & 反应 / Vue

Laravel Breeze 还通过一个Inertia 前端实现。 Inertia 允许您使用经典的服务器端路由和控制器构建现代的单页 React 和 Vue 应用程序。

Inertia 让您享受 React 和 Vue 的前端强大功能以及 Laravel 令人难以置信的后端生产力和闪电般的速度Vite 汇编。要使用惯性堆栈，请指定vue 或者react 作为执行时所需的堆栈breeze:install 工匠命令。安装 Breeze 的脚手架后，您还应该编译应用程序的前端资产：

php artisan breeze:install vue

# Or...

php artisan breeze:install react

php artisan migrate
npm install
npm run dev

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

服务器端渲染

如果您希望 Breeze 为以下项目提供脚手架支持惯性SSR, 你可以提供ssr调用时的选项breeze:install 命令：

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

#微风 & Next.js / API

Laravel Breeze 还可以构建一个身份验证 API，该 API 已准备好对现代 JavaScript 应用程序进行身份验证，例如由Next,Nuxt， 和别的。要开始，请指定api 执行时堆栈为您想要的堆栈breeze:install 工匠命令：

php artisan breeze:install api

php artisan migrate

在安装过程中，Breeze 将添加一个FRONTEND_URL 应用程序的环境变量.env 文件。此 URL 应该是您的 JavaScript 应用程序的 URL。这通常是http://localhost:3000 在本地开发过程中。此外，您应该确保您的APP_URL 被设定为http://localhost:8000，这是使用的默认 URLserve 工匠命令。

Next.js 参考实现

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

#Laravel 喷射流

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

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

安装 Laravel Jetstream 的完整文档可以在Jetstream 官方文档.