入门套件
入门套件
介绍
为了让您开始构建新的 Laravel 应用程序,我们很高兴提供身份验证和应用程序入门工具包。 这些工具包会自动为您的应用程序提供注册和验证应用程序用户所需的路由、控制器和视图。
虽然欢迎您使用这些入门套件,但它们不是必需的。 只需安装一个新的 Laravel 副本,您就可以自由地从头开始构建自己的应用程序。 无论哪种方式,我们都知道你会创造出伟大的东西!
Laravel Breeze
Laravel Breeze 是 Laravel 的所有 认证功能 的最小、简单的实现,包括登录、注册、密码 重置、电子邮件验证和密码确认。 Laravel Breeze 的默认视图层由简单的 Blade 模板 组成,并使用 Tailwind CSS 进行样式设置。或者,Breeze 可以使用 Vue 或 React 和Inertia构建您的应用程序
Breeze 为开始一个全新的 Laravel 应用程序提供了一个很好的起点,也是计划使用Laravel Livewire将其 Blade 模板提升到新水平的项目的绝佳选择。
安装
首先,您应该创建一个新的 Laravel 应用程序,配置您的数据库,并运行您的数据库迁移。一旦你创建了一个新的 Laravel 应用程序,你就可以使用 Composer 安装 Laravel Breeze:
composer require laravel/breeze --dev
安装 Breeze 后,您可以使用以下文档中讨论的 Breeze“栈”之一来搭建您的应用程序。
Breeze & Blade
Composer 安装好 Laravel Breeze 包后,你可以运行breeze:install
Artisan 命令。此命令将身份验证视图、路由、控制器和其他资源发布到您的应用程序。Laravel Breeze 将其所有代码发布到您的应用程序,以便您可以完全控制和查看其功能和实现。
默认的 Breeze “栈”是 Blade 堆栈,它使用简单的Blade 模板来呈现应用程序的前端。可以通过调用breeze:install
命令来安装 Blade 堆栈,而无需其他附加参数。安装 Breeze 的脚手架后,您还应该编译应用程序的前端资产:
php artisan breeze:install
npm install
npm run dev
php artisan migrate
接下来,您可以在 Web 浏览器中导航到应用程序的 /login
或 /register
URL。 Breeze 的所有路由都在 routes/auth.php
文件中定义。
技巧:要了解有关编译应用程序的 CSS 和 JavaScript 的更多信息,请查看 Laravel Vite 文档。
Breeze & React / Vue
Laravel Breeze 还通过Inertia前端实现提供 React 和 Vue 脚手架。Inertia 允许您使用经典的服务器端路由和控制器构建现代的单页 React 和 Vue 应用程序。
Inertia 让您享受 React 和 Vue 的前端功能以及 Laravel 令人难以置信的后端生产力和闪电般快速的Vite编译。要使用Inertia技术栈,请在执行breeze:install
Artisan 命令时指定vue
或react
作为所需的技术栈。安装 Breeze 的脚手架后,您还应该编译应用程序的前端资产:
php artisan breeze:install vue
# Or...
php artisan breeze:install react
npm install
npm run dev
php artisan migrate
接下来,您可以在 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,该 API 已准备好对现代 JavaScript 应用程序进行身份验证,例如由 Next、Nuxt 等提供支持的应用程序。 首先,在执行 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 参考实现
最后,您已准备好将此后端与您选择的前端配对。 GitHub 上提供了 Breeze 前端的 Next 参考实现。该前端由 Laravel 维护,包含与 Breeze 提供的传统 Blade 和 Inertia 堆栈相同的用户界面。
Laravel Jetstream
Laravel Breeze 提供了一个简单的、最小化的起点来构建 Laravel 应用,而 Jetstream 则通过更强大的功能和额外的前端技术堆栈来对应用功能进行增强。 对于那些刚接触 Laravel 的人,我们建议在学习 Laravel Jetstream 之前先学习 Laravel Breeze。
Jetstream 为 Laravel 提供了精美设计的应用程序脚手架代码,包括登录、注册、邮箱验证、双因子认证、会话管理、基于 Laravel Sanctum 的 API 支持,以及可选的团队管理功能。Jetstream 使用 Tailwind CSS 设计样式,并提供 Livewire 或 Inertia 驱动的前端脚手架技术栈供你选择。
Laravel Jetstream 的安装使用完整文档位于 Jetstream 官方文档.
原文地址:cndocs/9.x/sta...
译文地址:cndocs/9.x/sta...