Skip to content

启动套件

介绍

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

虽然您可以使用这些启动套件,但并不是必须的。您可以通过简单地安装一个全新的 Laravel 副本,从头开始构建自己的应用程序。无论如何,我们相信您会构建出一些伟大的东西!

Laravel Breeze

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

Laravel Breeze 的默认视图层由简单的 Blade 模板 组成,并使用 Tailwind CSS 进行样式化。或者,Breeze 可以使用 Vue 或 React 和 Inertia 来搭建您的应用程序。

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

Laravel Bootcamp

如果您是 Laravel 新手,请随时跳入 Laravel Bootcamp。Laravel Bootcamp 将引导您通过使用 Breeze 构建您的第一个 Laravel 应用程序。这是了解 Laravel 和 Breeze 所有功能的绝佳方式。

安装

首先,您应该 创建一个新的 Laravel 应用程序,配置您的数据库,并运行您的 数据库迁移。创建新 Laravel 应用程序后,您可以使用 Composer 安装 Laravel Breeze:

shell
composer require laravel/breeze --dev

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

Breeze & Blade

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

默认的 Breeze “堆栈”是 Blade 堆栈,它利用简单的 Blade 模板 来渲染您的应用程序前端。Blade 堆栈可以通过调用 breeze:install 命令而不带任何其他附加参数来安装。安装 Breeze 的脚手架后,您还应该编译应用程序的前端资产:

shell
php artisan breeze:install

php artisan migrate
npm install
npm run dev

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

暗黑模式

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

shell
php artisan breeze:install --dark
lightbulb

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

Breeze & React / Vue

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

Inertia 让您享受 React 和 Vue 的前端强大功能,结合 Laravel 的惊人后端生产力和闪电般快速的 Vite 编译。要使用 Inertia 堆栈,请在执行 breeze:install Artisan 命令时指定 vuereact 作为所需的堆栈。安装 Breeze 的脚手架后,您还应该编译应用程序的前端资产:

shell
php artisan breeze:install vue

# 或...

php artisan breeze:install react

php artisan migrate
npm install
npm run dev

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

服务器端渲染

如果您希望 Breeze 为 Inertia SSR 提供支持,您可以在调用 breeze:install 命令时提供 ssr 选项:

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

Breeze & Next.js / API

Laravel Breeze 还可以搭建一个准备好为现代 JavaScript 应用程序(如 NextNuxt 等)进行身份验证的 API。要开始,请在执行 breeze:install Artisan 命令时指定 api 堆栈作为所需的堆栈:

shell
php artisan breeze:install api

php artisan migrate

在安装过程中,Breeze 会将 FRONTEND_URL 环境变量添加到您的应用程序的 .env 文件中。此 URL 应该是您的 JavaScript 应用程序的 URL。在本地开发期间,这通常是 http://localhost:3000。此外,您还应该确保您的 APP_URL 设置为 http://localhost:8000,这是 serve Artisan 命令使用的默认 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 驱动的前端脚手架。

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