什么是 Form Request 类？

Question

什么是 Form Request 类？

Accepted Answer

**Form Request** 类是自定义请求类，它们**为特定请求封装验证（和授权）逻辑**。它们将验证规则从控制器转移到专门的、可重用的类中 — 保持控制器轻量级并使验证组织有序。

## 创建和使用 Form Request

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // AUTHORIZATION check
    }

public function rules(): array {
        return [                                              // VALIDATION rules
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // custom messages
    }
}
```

```php
// type-hint the Form Request in the controller — validation runs AUTOMATICALLY
public function store(StoreUserRequest $request) {
    // if we reach here, validation AND authorization already PASSED
    User::create($request->validated());   // get the validated data
}
```

当你在控制器方法中类型提示一个 Form Request 时，Laravel **在方法执行之前自动运行其授权和验证** — 如果其中任何一个失败，请求将被拒绝（授权返回 403，验证返回 422/重定向），你的方法永远不会运行。所以在方法内部，你知道数据是有效的并且操作已授权。

## 优点

```text
✓ Thin controllers — validation/authorization logic lives in the Form Request, not the controller
✓ Reusable — use the same request class across multiple endpoints
✓ Organized — rules, messages, and authorization for a request are in one place
✓ Combines validation AND authorization — both checked automatically before the controller
✓ Access prepared/validated data cleanly via $request->validated()
```

## 为什么这很重要

Form Request 类是在 Laravel 中组织验证和授权的重要最佳实践 — 对于任何超出平凡验证的情况，它们都是推荐的方法，因此理解它们对于编写可维护的 Laravel 应用程序很有价值。

它们的关键优势是保持**控制器轻量级**：通过将验证规则和授权逻辑转移到专门的类中（Laravel 在控制器方法之前自动运行），控制器保持专注于其核心逻辑，同时确保在执行时数据已验证且操作已授权。

这种分离使代码更加**有组织**（一个请求的所有规则、自定义消息和授权在一个内聚的位置）、**可重用**（同一个 Form Request 可以在多个端点中使用）和更清洁。

在一个类中**验证和授权**的自动组合 — 两者都在控制器运行前检查，自动拒绝无效或未授权的请求 — 是优雅的并减少了样板代码。

理解 Form Requests、它们如何自动运行以及从控制器中提取验证/授权的优点反映了成熟的 Laravel 实践，对于构建结构良好的应用程序很重要，因为验证和授权是普遍存在的关注点，Form Requests 是 Laravel 处理非平凡情况的干净、习语化的方式 — 这是专业、可维护 Laravel 代码的标志。