表单验证请求 (Form Request)

当你的控制器中充斥着复杂的验证逻辑时，代码会变得难以维护。Anon Framework Next 提供了 FormRequest 类，允许你将验证规则和授权逻辑完全从控制器中剥离出来。

---

创建 FormRequest 类

你可以继承 Anon\Core\Http\FormRequest 来创建一个独立的请求类。

namespace App\Http\Requests;

use Anon\Core\Http\FormRequest;

class StoreUserRequest extends FormRequest
{
    /**
     * 判断用户是否有权限发起请求
     */
    public function authorize(): bool
    {
        // 这里可以判断当前登录用户的权限
        return true;
    }

    /**
     * 定义验证规则
     */
    public function rules(): array
    {
        return [
            'username' => 'required|min:4|max:20',
            'email'    => 'required|email',
            'password' => 'required|min:6'
        ];
    }

    /**
     * 自定义验证错误提示 (可选)
     */
    public function messages(): array
    {
        return [
            'username.required' => '用户名不能为空',
            'email.email'       => '请输入有效的邮箱地址'
        ];
    }
}

---

在控制器中使用

创建好请求类后，只需在控制器的方法参数中类型提示该请求类即可。

框架的 依赖注入容器 和 路由系统 会在执行控制器方法前，自动实例化 StoreUserRequest，并执行其中的权限验证 (authorize) 和数据验证 (rules)。

• 如果 authorize 返回 false，将抛出 403 Forbidden。
• 如果数据验证失败，将抛出 422 Unprocessable Entity。

namespace Anon\Controller;

use Anon\Http\Requests\StoreUserRequest;
use Anon\Core\Http\Response;

class UserController
{
    // 在进入 store 方法前，验证就已经自动完成了！
    public function store(StoreUserRequest $request): Response
    {
        // 直接获取已验证通过的参数
        $data = $request->post;

        // ... 执行入库逻辑
        
        return Response::json(['message' => 'User created']);
    }
}

这种模式让你的控制器代码保持简洁。