Laravel怎么处理表单验证_Laravel自定义Request验证规则【技巧】

8次阅读

在 FormRequest 中写验证逻辑最稳妥,因其更易复用、测试,并天然支持授权;需通过 artisan 命令生成,实现 authorize()、rules()、messages() 和 attributes() 方法,控制器中类型提示即可自动验证。

Laravel怎么处理表单验证_Laravel自定义Request验证规则【技巧】

直接在 FormRequest 里写验证逻辑是最稳妥的方式,比在控制器里用 validate() 更易复用、更易测试,也天然支持授权(authorize() 方法)。

怎么创建和注册自定义 FormRequest

用 Artisan 命令生成最省事:

php artisan make:request StorePostRequest

生成的类默认放在 app/http/Requests/ 下。关键点有三个:

  • authorize() 返回 false 会直接中断请求并返回 403,适合做权限判断(比如“只有作者才能编辑”)
  • rules() 必须返回数组,键是字段名,值是规则字符串或数组(如 'title' => 'required|String|max:255''email' => ['required', 'email', 'unique:users']
  • 别忘了在控制器方法参数中类型提示它,laravel 会自动实例化并执行验证:public function store(StorePostRequest $request)

怎么在 FormRequest 中复用已有规则或加条件验证

很多场景不是简单写死规则,比如“仅当 status 是 draft 时 title 可为空”,这时不能只靠数组规则表达:

  • Rule::requiredIf()Rule::sometimes() 等辅助类,它们属于 IlluminateValidationRule
  • rules() 方法里写逻辑判断更清晰,比如:
    return [ 'title' => $this->status === 'draft' ? 'Nullable|string' : 'required|string', ];
  • 注意:不要在 rules() 里调用 $request->input() —— 此时原始输入还没经过过滤,应直接用 $this->statusFormRequest 会自动代理所有 input 键)

怎么添加自定义错误消息或翻译

默认错误消息来自语言包,但字段名和提示常不够贴切:

  • 重写 messages() 方法,返回字段+规则维度的提示,例如:
    return ['title.required' => '标题不能为空哦'];
  • 重写 attributes() 方法统一改字段别名,避免重复写:
    return ['title' => '文章标题', 'content' => '正文内容'];
  • 如果项目开了多语言,别硬编码中文,把文案放到 resources/lang/zh/validation.phpattributescustom 数组里更规范

为什么 validate() 在控制器里有时不生效或报错

常见于手动调用 $request->validate() 时出问题:

  • 传入的规则数组键名必须和实际提交字段完全一致(包括嵌套字段如 user.name),否则规则被忽略
  • 如果用了 withValidator() 扩展验证器(比如加 after 回调),它只在 FormRequest 中有效,在控制器里调 validate() 不会触发
  • 控制器里验证失败默认跳回上一页,但 API 场景需要 jsON 响应 —— 此时务必用 FormRequest,或手动 catch ValidationException 并 return response()->json()

真正麻烦的是嵌套数组验证(比如 tags.*.name)和存在性检查(exists:posts,id,category_id,1)的组合,这时候光靠字符串规则容易漏条件,建议拆成 Rule::exists() 链式调用,并在 withValidator() 里补业务级校验逻辑。

text=ZqhQzanResources