启动套件

什么是启动套件

启动套件是 Laravel 官方为应用起点准备的脚手架。它能一次性搭建登录、注册、密码重置、邮箱验证等认证功能以及对应的 UI。在使用 laravel new 创建应用时选择启动套件，就会自动生成认证相关的路由、控制器、视图与前端代码。生成的所有代码都存在于你自己的应用中，可以自由定制。

Laravel 13 已废弃传统的 Breeze 与 Jetstream。新项目请使用下方介绍的启动套件。现有的使用 Breeze / Jetstream 的项目仍能继续运行，但新开发不再推荐。

可用的启动套件

Laravel 13 提供了以下 4 种启动套件。

React

使用 React 19、TypeScript、Tailwind 4、shadcn/ui 的现代化 SPA。通过 Inertia.js 可以在保持服务端路由的同时使用 React。

Vue

采用 Vue 3 Composition API、TypeScript、Tailwind 与 shadcn-vue。与 React 相同，也通过 Inertia.js 与服务端连接。

Livewire

使用 Livewire，只用 PHP 就可以构建动态 UI。最适合以 Blade 模板为主的团队，或希望不使用 JavaScript 框架的场景。使用 Flux UI。

Svelte

基于 Svelte 5、TypeScript、Tailwind 与 shadcn-svelte 的 SPA。结合 Inertia.js 可构建现代化前端。

应该选哪一个

启动套件	适合的团队
React	熟悉 React 生态与 TypeScript 的团队
Vue	有 Vue 或 Nuxt 经验的团队
Livewire	以 PHP 与 Blade 为中心开发的团队
Svelte	有 Svelte / SvelteKit 经验的团队

无论选择哪一个，认证功能都完全相同。请选择团队最熟悉的前端技术。

想全面了解 Blade、Livewire、Inertia、独立 SPA 的差异，可以先阅读前端。

安装方法

启动套件在创建项目时选择。执行 laravel new 时会有交互式提示。

安装 Laravel 安装器

如果尚未安装，通过 Composer 获取 Laravel 安装器。

composer global require laravel/installer

创建新应用

执行 laravel new 命令。会出现包含启动套件选择的交互式提示。

laravel new my-app

在提示中选择 React、Vue、Livewire、Svelte 中的一种。还可选择使用标准 Laravel 认证或 WorkOS AuthKit。

安装前端依赖

cd my-app
npm install && npm run build

准备数据库

确认 .env 中的数据库配置后运行迁移。

php artisan migrate

启动开发服务器

composer run dev

访问 http://localhost:8000，导航栏会显示「Register」「Log in」链接。

启动套件安装后可立即使用以下认证功能：

功能	URL
用户注册	`/register`
登录	`/login`
密码重置	`/forgot-password`
邮箱验证	`/email/verify`
编辑个人资料	`/settings/profile`

定制启动套件

生成的代码都在你自己的应用中，可以自由修改。前端代码大多位于 resources/js（Livewire 由于是 Blade，位于 resources/views）。

切换布局

每个启动套件都提供了「侧边栏」和「顶部栏」两种布局。默认使用侧边栏布局。

React
Vue
Livewire
Svelte

编辑 resources/js/layouts/app-layout.tsx。

// 侧边栏布局（默认）
import AppLayoutTemplate from '@/layouts/app/app-sidebar-layout';

// 切换到顶部栏布局
import AppLayoutTemplate from '@/layouts/app/app-header-layout';

编辑 resources/js/layouts/AppLayout.vue。

// 侧边栏布局（默认）
import AppLayout from '@/layouts/app/AppSidebarLayout.vue';

// 切换到顶部栏布局
import AppLayout from '@/layouts/app/AppHeaderLayout.vue';

编辑 resources/views/layouts/app.blade.php。

{{-- 切换到顶部栏布局 --}}
<x-layouts::app.header>
    <flux:main container>
        {{ $slot }}
    </flux:main>
</x-layouts::app.header>

编辑 resources/js/layouts/AppLayout.svelte。

// 侧边栏布局（默认）
import AppLayout from '@/layouts/app/AppSidebarLayout.svelte';

// 切换到顶部栏布局
import AppLayout from '@/layouts/app/AppHeaderLayout.svelte';

修改认证页面布局

React
Vue
Livewire
Svelte

编辑 resources/js/layouts/auth-layout.tsx。

// 简约布局（默认）
import AuthLayoutTemplate from '@/layouts/auth/auth-simple-layout';

// 切换到分栏布局
import AuthLayoutTemplate from '@/layouts/auth/auth-split-layout';

编辑 resources/js/layouts/AuthLayout.vue。

import AuthLayout from '@/layouts/auth/AuthSimpleLayout.vue';

// 切换到分栏布局
import AuthLayout from '@/layouts/auth/AuthSplitLayout.vue';

编辑 resources/views/layouts/auth.blade.php。

<x-layouts::auth.split>
    {{ $slot }}
</x-layouts::auth.split>

编辑 resources/js/layouts/AuthLayout.svelte。

import AuthLayout from '@/layouts/auth/AuthSimpleLayout.svelte';

// 切换到分栏布局
import AuthLayout from '@/layouts/auth/AuthSplitLayout.svelte';

定制注册逻辑

启动套件使用 app/Actions/Fortify 目录下的 Action 类处理用户注册与密码重置等。例如要在注册时添加手机号字段，请编辑 CreateNewUser.php。

public function create(array $input): User
{
    Validator::make($input, [
        'name' => ['required', 'string', 'max:255'],
        'email' => ['required', 'email', 'max:255', 'unique:users'],
        'phone' => ['required', 'string', 'max:20'],
        'password' => $this->passwordRules(),
    ])->validate();

    return User::create([
        'name' => $input['name'],
        'email' => $input['email'],
        'phone' => $input['phone'],
        'password' => Hash::make($input['password']),
    ]);
}

WorkOS AuthKit 认证

在执行 laravel new 时也可以选择 WorkOS AuthKit 作为认证提供方。使用 WorkOS AuthKit 会新增以下功能：

社交登录（Google、Microsoft、GitHub、Apple）
Passkey 认证
邮件 Magic Auth
SSO（单点登录）

使用 WorkOS AuthKit 需要 WorkOS 账户。月活跃用户 100 万以内免费。

若选择 WorkOS，在 .env 中设置以下环境变量：

WORKOS_CLIENT_ID=your-client-id
WORKOS_API_KEY=your-api-key
WORKOS_REDIRECT_URL="${APP_URL}/authenticate"

注意事项

启动套件在创建项目时选择。无法后加到已有项目中。若已有项目需要认证 UI，请新建项目时选择启动套件，或手动实现认证功能。

下一步

认证入门

进一步了解 Auth 门面用法、路由保护等 Laravel 认证功能。

入门

基础

请求处理

数据库

认证

辅助函数与外部通信

测试与部署

AI 开发辅助

什么是启动套件

可用的启动套件

React

Vue

Livewire

Svelte

应该选哪一个

安装方法

定制启动套件

切换布局

修改认证页面布局

定制注册逻辑

WorkOS AuthKit 认证

注意事项

下一步

认证入门

​什么是启动套件

​可用的启动套件

React

Vue

Livewire

Svelte

​应该选哪一个

​安装方法

​定制启动套件

​切换布局

​修改认证页面布局

​定制注册逻辑

​WorkOS AuthKit 认证

​注意事项

​下一步

认证入门

什么是启动套件

可用的启动套件

应该选哪一个

安装方法

定制启动套件

切换布局

修改认证页面布局

定制注册逻辑

WorkOS AuthKit 认证

注意事项

下一步