入门套件
简介
为了帮助您快速开始构建新的 Laravel 应用程序,我们很高兴提供身份验证和应用程序入门套件。这些套件会自动为您的应用程序构建所需的路由、控制器和视图,以注册和验证应用程序的用户。
虽然您可以使用这些入门套件,但它们不是必需的。您可以通过简单地安装 Laravel 的新副本从头开始构建自己的应用程序。无论哪种方式,我们都知道您将构建出很棒的东西!
Laravel Breeze
Laravel Breeze 是 Laravel 所有 身份验证功能(包括登录、注册、密码重置、电子邮件验证和密码确认)的极简、简单的实现。此外,Breeze 还包含一个简单的“个人资料”页面,用户可以在其中更新他们的姓名、电子邮件地址和密码。
Laravel Breeze 的默认视图层由简单的 Blade 模板 组成,并使用 Tailwind CSS 进行样式设置。此外,Breeze 还提供了基于 Livewire 或 Inertia 的脚手架选项,可以选择使用 Vue 或 React 作为基于 Inertia 的脚手架。
Laravel 集训营
如果您是 Laravel 的新手,请随时参加 Laravel 集训营。Laravel 集训营将指导您使用 Breeze 构建您的第一个 Laravel 应用程序。这是一种了解 Laravel 和 Breeze 提供的所有功能的好方法。
安装
首先,您应该 创建一个新的 Laravel 应用程序。如果您使用 Laravel 安装程序 创建应用程序,则会在安装过程中提示您安装 Laravel Breeze。否则,您需要按照以下手动安装说明进行操作。
如果您已创建了一个没有入门套件的新 Laravel 应用程序,则可以使用 Composer 手动安装 Laravel Breeze
composer require laravel/breeze --dev
Composer 安装 Laravel Breeze 包后,您应该运行 breeze:install
Artisan 命令。此命令将身份验证视图、路由、控制器和其他资源发布到您的应用程序。Laravel Breeze 将其所有代码发布到您的应用程序,以便您可以完全控制并查看其功能和实现。
breeze:install
命令将提示您选择首选的前端堆栈和测试框架
php artisan breeze:install php artisan migratenpm installnpm run dev
Breeze 和 Blade
默认的 Breeze “堆栈”是 Blade 堆栈,它利用简单的 Blade 模板 呈现应用程序的前端。可以通过在不带任何其他参数的情况下调用 breeze:install
命令并选择 Blade 前端堆栈来安装 Blade 堆栈。安装 Breeze 的脚手架后,您还应该编译应用程序的前端资源
php artisan breeze:install php artisan migratenpm installnpm run dev
接下来,您可以在网络浏览器中导航到应用程序的 /login
或 /register
URL。所有 Breeze 的路由都定义在 routes/auth.php
文件中。
要了解有关编译应用程序的 CSS 和 JavaScript 的更多信息,请查看 Laravel 的 Vite 文档。
Breeze 和 Livewire
Laravel Breeze 还提供 Livewire 脚手架。Livewire 是一种使用 PHP 构建动态、反应式前端 UI 的强大方法。
对于主要使用 Blade 模板并正在寻找 Vue 和 React 等 JavaScript 驱动的 SPA 框架的更简单替代方案的团队来说,Livewire 非常适合。
要使用 Livewire 堆栈,您可以在执行 breeze:install
Artisan 命令时选择 Livewire 前端堆栈。安装 Breeze 的脚手架后,您应该运行数据库迁移
php artisan breeze:install php artisan migrate
Breeze 和 React/Vue
Laravel Breeze 还通过 Inertia 前端实现提供 React 和 Vue 脚手架。Inertia 允许您使用经典的服务器端路由和控制器构建现代的单页 React 和 Vue 应用程序。
Inertia 允许您享受 React 和 Vue 的前端强大功能,并结合 Laravel 的出色后端生产力和超快的 Vite 编译。要使用 Inertia 堆栈,您可以在执行 breeze:install
Artisan 命令时选择 Vue 或 React 前端堆栈。
选择 Vue 或 React 前端堆栈时,Breeze 安装程序还会提示您确定是否需要 Inertia SSR 或 TypeScript 支持。安装 Breeze 的脚手架后,您还应该编译应用程序的前端资源
php artisan breeze:install php artisan migratenpm installnpm run dev
接下来,您可以在网络浏览器中导航到应用程序的 /login
或 /register
URL。所有 Breeze 的路由都定义在 routes/auth.php
文件中。
Breeze 和 Next.js/API
Laravel Breeze 还可以构建一个准备验证现代 JavaScript 应用程序(例如由 Next、Nuxt 等提供支持的应用程序)的身份验证 API。要开始使用,在执行 breeze:install
Artisan 命令时选择 API 堆栈作为所需的堆栈
php artisan breeze:install php artisan migrate
在安装过程中,Breeze 会将 FRONTEND_URL
环境变量添加到应用程序的 .env
文件中。此 URL 应该是 JavaScript 应用程序的 URL。在本地开发期间,这通常是 https://127.0.0.1:3000
。此外,您应该确保 APP_URL
设置为 https://127.0.0.1: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 设计,并提供您选择的 Livewire 或 Inertia 驱动的前端脚手架。
安装 Laravel Jetstream 的完整文档可以在 官方 Jetstream 文档 中找到。