什么是 Laravel Jetstream 及怎么使用它？

封面图 • 2025-11-22 • PHP

Laravel Jetstream 是 Laravel 框架提供的一个官方认证系统（Authentication System），它为 Laravel 应用程序提供了一个现代、可定制的用户认证解决方案。Jetstream 通常用于创建具有登录、注册、密码重置、双因素认证（2FA）等功能的 Web 应用。

---

## 🧾 Laravel Jetstream 的特点

- **支持多种认证方式**：包括传统的用户名/密码登录，以及基于电子邮件的登录。
- **支持多角色系统**（通过 Laravel Breeze 或其他包扩展）。
- **支持双因素认证（2FA）**（使用 `spatie/laravel-2fa` 包）。
- **支持 API 认证**（通过 Laravel Sanctum 或 Passport）。
- **前端支持**：Jetstream 提供了 Vue.js 或 Livewire 的前端模板，方便快速搭建 UI。
- **易于定制**：你可以根据需要修改其模板和逻辑。

---

## 🛠️ 如何安装 Laravel Jetstream

### 步骤 1：创建一个新的 Laravel 项目（如果还没有）

```bash
composer create-project laravel/laravel jetstream-demo
cd jetstream-demo
```

### 步骤 2：安装 Laravel Jetstream

```bash
composer require laravel/jetstream
```

### 步骤 3：发布 Jetstream 的配置文件和视图

```bash
php artisan vendor:publish laravel/jetstream
```

或者使用以下命令来选择前端框架（Vue 或 Livewire）：

```bash
php artisan jetstream:install vue
// 或者
php artisan jetstream:install livewire
```

> 💡 注意：如果你使用的是 Laravel 9 或更高版本，Jetstream 已经内置在 Laravel 中，可以使用 `php artisan jetstream:install` 命令。

### 步骤 4：运行迁移并生成模型

```bash
php artisan migrate
```

这会创建用户表和其他相关表（如 `password_resets`、`two_factor_codes` 等）。

### 步骤 5：启动应用

```bash
php artisan serve
```

然后访问 `http://localhost:8000`，你应该能看到 Jetstream 的登录页面。

---

## 📁 文件结构

Jetstream 安装后会在以下目录中添加文件：

- `resources/views/auth`：包含登录、注册等页面模板。
- `app/Http/Controllers/Auth`：认证相关的控制器。
- `routes/web.php`：认证路由。
- `config/jetstream.php`：Jetstream 配置文件。

---

## 🧪 示例功能说明

### 1. 登录和注册

访问 `http://localhost:8000/login` 或 `http://localhost:8000/register`，即可使用默认的登录和注册页面。

### 2. 双因素认证（2FA）

Jetstream 支持启用双因素认证。你可以在 `config/jetstream.php` 中开启它，并使用 `spatie/laravel-2fa` 包进行管理。

### 3. 密码重置

Jetstream 自动集成了密码重置功能，用户可以通过点击“忘记密码”链接来重置密码。

---

## ✅ 使用 Jetstream 的好处

| 优点 | 描述 |
|------|------|
| 快速搭建 | 提供完整的认证系统，无需从头开始写代码 |
| 可定制 | 可以轻松地修改视图和逻辑 |
| 官方支持 | 由 Laravel 团队维护，稳定可靠 |
| 支持多种前端 | Vue.js 或 Livewire 任选 |

---

## 🔧 高级使用（可选）

- **自定义视图**：你可以修改 `resources/views/auth` 下的模板文件。
- **集成 API 认证**：结合 Laravel Sanctum 实现前后端分离。
- **多角色系统**：通过 `laravel/roles` 或自定义模型实现。
- **双因素认证**：启用后，用户需要扫描二维码并输入验证码。

---

## 📚 参考文档

- [Laravel Jetstream 官方文档](https://jetstream.laravel.com/)
- [Laravel 官方文档 - Authentication](https://laravel.com/docs/authentication)

---

如果你有具体的使用场景（比如想用 Vue 还是 Livewire，是否需要 2FA 等），我可以为你提供更详细的指导！