Laravel 中文文档

主题

全部文档

起步套件 ​

简介 ​

为帮助你更快构建新的 Laravel 应用，我们提供了认证与应用起步套件。这些套件会自动为应用搭建注册与认证用户所需的路由、控制器和视图。

欢迎使用这些起步套件，但并非必需。你也可以直接安装全新的 Laravel，从零开始构建应用。无论哪种方式，我们相信你会做出出色的作品！

Laravel Breeze ​

Laravel Breeze 是对 Laravel 全部认证功能的精简实现，包括登录、注册、密码重置、邮箱验证与密码确认。此外，Breeze 还包含一个简单的「个人资料」页面，用户可在此更新姓名、邮箱和密码。

Laravel Breeze 的默认视图层由简单的 Blade 模板构成，并使用 Tailwind CSS 样式。此外，Breeze 还提供基于 Livewire 或 Inertia 的脚手架选项；Inertia 方案可选择 Vue 或 React。

Laravel Bootcamp ​

如果你是 Laravel 新手，欢迎体验 Laravel Bootcamp。Bootcamp 会带你使用 Breeze 构建第一个 Laravel 应用，是快速了解 Laravel 与 Breeze 能力的好方式。

安装 ​

首先，你应创建一个新的 Laravel 应用。若使用 Laravel 安装器创建应用，安装过程中会提示安装 Laravel Breeze。否则，请按下方手动安装说明操作。

如果你已经创建了未包含起步套件的新 Laravel 应用，可以使用 Composer 手动安装 Laravel Breeze：

shell
composer require laravel/breeze --dev

Composer 安装完 Laravel Breeze 包后，应运行 breeze:install Artisan 命令。该命令会将认证视图、路由、控制器及其他资源发布到你的应用中。Laravel Breeze 会把全部代码发布到应用内，便于你完全掌控并查看其功能与实现。

breeze:install 命令会提示你选择偏好的前端技术栈与测试框架：

shell
php artisan breeze:install

php artisan migrate
npm install
npm run dev

Breeze 与 Blade ​

Breeze 的默认「技术栈」是 Blade 栈，使用简单的 Blade 模板渲染应用前端。可通过运行 breeze:install（无需其他参数）并选择 Blade 前端栈来安装。安装完 Breeze 脚手架后，还应编译应用的前端资源：

shell
php artisan breeze:install

php artisan migrate
npm install
npm run dev

接下来，可在浏览器中访问应用的 /login 或 /register URL。Breeze 的全部路由定义在 routes/auth.php 文件中。

INFO

要了解如何编译应用的 CSS 与 JavaScript，请参阅 Laravel 的 Vite 文档。

Breeze 与 Livewire ​

Laravel Breeze 还提供 Livewire 脚手架。Livewire 让你仅用 PHP 就能构建动态、响应式的前端 UI。

Livewire 非常适合主要使用 Blade 模板、并希望用更简单的方式替代 Vue、React 等 JavaScript 驱动 SPA 框架的团队。

要使用 Livewire 栈，可在执行 breeze:install Artisan 命令时选择 Livewire 前端栈。安装完 Breeze 脚手架后，应运行数据库迁移：

shell
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 脚手架后，还应编译应用的前端资源：

shell
php artisan breeze:install

php artisan migrate
npm install
npm run dev

接下来，可在浏览器中访问应用的 /login 或 /register URL。Breeze 的全部路由定义在 routes/auth.php 文件中。

Breeze 与 Next.js / API ​

Laravel Breeze 还可以搭建一套认证 API，用于认证由 Next、Nuxt 等驱动的现代 JavaScript 应用。开始时，在执行 breeze:install Artisan 命令时选择 API 栈即可：

shell
php artisan breeze:install

php artisan migrate

安装过程中，Breeze 会在应用的 .env 文件中添加 FRONTEND_URL 环境变量。该 URL 应为你的 JavaScript 应用地址；本地开发通常为 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 设计，并提供 Livewire 或 Inertia 驱动的前端脚手架供你选择。

安装 Laravel Jetstream 的完整文档请参阅官方 Jetstream 文档。