Skip to content

入门套件

简介

为了让您开始构建新的 Laravel 应用程序,我们很高兴提供身份验证和应用程序入门工具包。 这些工具包会自动为您的应用程序提供注册和验证应用程序用户所需的路由、控制器和视图。

虽然欢迎您使用这些入门套件,但它们不是必需的。 只需安装一个新的 Laravel 副本,您就可以自由地从头开始构建自己的应用程序。 无论哪种方式,我们都知道你会创造出伟大的东西!

Laravel Breeze

Laravel Breeze 是 Laravel 所有 认证功能 的最小、简单实现,包括登录、注册、密码 重置、电子邮件验证和密码确认。 Laravel Breeze 的默认视图层由简单的 Blade 模板Tailwind CSS 样式组成。

Breeze 为开始一个全新的 Laravel 应用程序提供了一个很好的起点,对于计划使用 Laravel Livewire 将其 Blade 模板提升到新水平的项目来说,它也是一个很好的选择。

安装

首先,你应该创建一个新的 Laravel 应用程序,配置你的数据库,然后运行你的数据库迁移:

curl -s https://laravel.build/example-app | bash
 
cd example-app
 
php artisan migrate

一旦你创建了一个新的 Laravel 应用程序,你就可以使用 Composer 安装 Laravel Breeze:

composer require laravel/breeze --dev

在Composer安装了Laravel Breeze包后, 你可以运行breeze:install Artisan命令. 这个命令将认证的视图, 路由, 控制器, 和其他资源发布到你的应用程序. Laravel Breeze将其所有的代码发布到你的应用程序中,这样你就可以完全控制和了解其功能和实现。在Breeze安装完毕后, 你还应该编译你的资源, 这样你的应用程序的CSS文件就可以使用了:

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

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

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

Breeze & Inertia

Laravel Breeze 还提供了一个由 Vue 或 React 提供支持的 Inertia.js 前端实现。 要使用 Inertia 堆栈,请在执行 breeze:install Artisan 命令时指定 vuereact 作为所需的技术栈:

php artisan breeze:install vue
 
// Or...
 
php artisan breeze:install react
 
npm install
npm run dev
php artisan migrate

Breeze & Next.js / API

Laravel Breeze 还可以构建一个身份验证 API,该 API 已准备好对现代 JavaScript 应用程序进行身份验证,例如由 NextNuxt 等提供支持的应用程序。 首先,在执行 breeze:install Artisan 命令时,将 api 栈指定为所需的技术栈:

php artisan breeze:install api
 
php artisan migrate

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

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 设计的,您可以选择 LivewireInertia.js驱动的前端脚手架。

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