Laravel中如何使用表单请求类_Laravel FormRequest验证数据方法【详解】

14次阅读

Laravel 的 FormRequest 是推荐替代 $request->validate() 的标准做法,适用于规则复用、授权控制、自定义错误响应或含复杂逻辑的场景;需重写 authorize() 和 rules() 方法,并通过类型提示自动注入使用。

Laravel中如何使用表单请求类_Laravel FormRequest验证数据方法【详解】

直接说结论:laravelFormRequest 不是“可选的验证方式”,而是推荐在控制器方法中替代手写 $request->validate() 的标准做法——前提是你的表单逻辑有复用性、需授权控制或要集中管理规则。

什么时候该用 FormRequest 而不是 $request->validate()

不是所有表单都值得单独建一个类。以下情况才建议拆出 FormRequest

  • 同一个验证规则被多个控制器方法调用(比如后台和 API 都要创建用户)
  • 需要在验证前做权限判断(例如 authorize() 中检查当前用户能否编辑该资源)
  • 验证失败时要自定义错误响应格式(如返回 jsON 而非重定向)
  • 规则里包含复杂逻辑(如“当 status 为 draft 时,publish_at 必须为空”),放 rules() 方法里比塞进控制器更清晰

如何生成并配置一个 StorePostRequest

运行 Artisan 命令生成类:

php artisan make:request StorePostRequest

生成后需手动修改两个关键方法:

  • authorize():返回 true 允许继续,false 直接 403;常用来查 Auth::user()->can('create', Post::class)
  • rules():返回规则数组,字段名必须与前端提交的键一致;支持闭包Rule::exists() 等高级用法

示例:

public function rules() {     return [         'title' => 'required|string|max:255',         'content' => 'required|string',         'category_id' => 'required|exists:categories,id',         'tags' => 'array',         'tags.*' => 'string|exists:tags,name',     ]; }

在控制器中使用 FormRequest 的正确姿势

不要手动实例化,也不要传 Request 再调 validate() —— Laravel 会自动注入并触发验证流程:

public function store(StorePostRequest $request) {     // 此处 $request 已通过验证,且 authorize() 已执行     $post = Post::create($request->validated());     return redirect()->route('posts.index'); }

注意几个易错点:

  • 参数类型提示必须是具体的 FormRequest 子类,不能是 RequestFormRequest 父类
  • $request->validated() 只返回通过规则的字段,比 $request->all() 更安全
  • 若需获取原始输入(包括未通过验证的字段),用 $request->all(),但需自行过滤
  • 验证失败默认重定向回上一页(带错误和旧输入),API 场景下会返回 json 错误,无需额外处理

常见问题为什么 authorize() 总返回 false?

这是最常被忽略的一环。Laravel 默认实现是 return false;,你必须显式改写:

public function authorize() {     // 比如只允许管理员创建文章     return Auth::check() && Auth::user()->is_admin; }

如果忘记改,所有请求都会被拦截并返回 403,且不报具体错误——日志里也看不到验证失败记录,容易误判为路由中间件问题。

另外,authorize() 在验证规则执行前就运行,所以它不能依赖 $request->input() 中的值(除非你确认该字段一定存在且已通过初步过滤)。

text=ZqhQzanResources