入门套件


介绍

为了让你在构建新的 Laravel 应用程序时有一个快速的起点,我们很高兴提供认证和应用程序入门套件。这些套件会自动为你的应用程序创建所需的路由、控制器和视图,以便注册和认证你的应用程序用户。

虽然你可以使用这些入门套件,但并非必需。你可以通过安装全新的 Laravel 来从头开始构建自己的应用程序。无论哪种方式,我们相信你会构建出很棒的应用程序!

Laravel Breeze

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

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

Breeze为开始一个全新的 Laravel 应用程序提供了一个出色的起点,也是计划使用 Laravel Livewire 将他们的 Blade 模板提升到下一个级别的项目的绝佳选择。

img

Laravel Bootcamp

如果您是 Laravel 的新手,请随意参加 Laravel Bootcamp。Laravel Bootcamp 将指导您使用 Breeze 构建第一个 Laravel 应用程序。这是了解 Laravel 和 Breeze 提供的所有功能的绝佳方式。

安装

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

composer require laravel/breeze --dev

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

Breeze 和 Blade

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

默认的Breeze“stack”是 Blade stack,它使用简单的 Blade 模板来呈现应用程序的前端。可以通过使用不添加其他附加参数的 breeze:install 命令来安装 Blade stack。在安装 Breeze 的脚手架之后,还应编译应用程序的前端资源:

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

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

暗黑模式

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

php artisan breeze:install --dark

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

Breeze & React / Vue

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

Inertia 允许您结合 React 和 Vue 的前端功能以及 Laravel 和快速 Vite 编译的后端生产力。要使用 Inertia stack,请在执行 breeze:install Artisan命令时指定 vuereact 作为所需的 stack。安装了 Breeze 的脚手架之后,您还应该编译应用程序的前端资源:

php artisan breeze:install vue

# Or...

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 选项:

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

Breeze & Next.js / API

Laravel Breeze 还可以构建一个认证 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,这是 serve Artisan 命令使用的默认 URL。

Next.js 参考实现

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

Laravel Jetstream

Laravel Jetstream 是对 Laravel 应用程序的功能更强大的增强,具有更多的前端技术堆栈。对于那些刚接触 Laravel 的人,我们建议先使用 Laravel Breeze 来学习,然后再升级到 Laravel Jetstream。

Jetstream 为 Laravel 提供了一个精美设计的应用程序脚手架,包括登录、注册、电子邮件验证、双因素认证、会话管理、通过 Laravel Sanctum 支持的 API 和可选的团队管理。Jetstream 使用 Tailwind CSS 进行设计,并提供了基于 LivewireInertia 的前端脚手架选择。

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


点赞 取消点赞 收藏 取消收藏

<< 上一篇: 前端

>> 下一篇: 部署