如何创建可兼顾新增与更新的通用Laravel FormRequest类?
同一FormRequest类适配新增、更新场景的实现方案
完全不需要为store、update两个场景单独创建两个FormRequest类,Laravel的FormRequest原生支持动态生成校验规则,只要在rules方法中根据当前请求的路由参数判断操作场景,动态调整unique校验的参数即可。
核心实现逻辑
- 提取两个场景的通用校验规则:
required(必填)是新增、更新场景都需要的校验逻辑,直接作为name字段的基础规则 - 从当前请求的路由中获取目标品牌ID:
- 新增场景的路由通常不带品牌ID参数,获取到的ID为空,此时直接套用全表唯一校验
unique:brands - 更新场景的路由必然携带品牌ID参数(无论是否开启路由模型绑定),此时在unique规则中追加排除当前ID的参数,即
unique:brands,id,当前品牌ID
- 新增场景的路由通常不带品牌ID参数,获取到的ID为空,此时直接套用全表唯一校验
- 把通用规则和动态生成的unique规则拼接成完整的校验规则数组,返回给框架执行校验
完整可运行的类代码
<?php namespace App\Http\Requests; use Illuminate\Foundation\Http\FormRequest; class BrandRequest extends FormRequest { /** * 操作权限校验,按自身业务逻辑调整即可 */ public function authorize() { return true; } /** * 动态生成适配场景的校验规则 */ public function rules() { // 初始化两个场景共用的基础规则 $nameRules = ['required']; // 获取路由中携带的品牌ID:兼容路由模型绑定、普通路由传参两种形式 // 路由模型绑定下,$this->route('brand') 返回Brand模型实例,取id属性 // 普通传参下,$this->route('brand') 直接返回传入的数字ID $targetBrand = $this->route('brand'); $brandId = is_object($targetBrand) ? $targetBrand->id : $targetBrand; if ($brandId) { // 更新场景:唯一校验排除当前记录 $nameRules[] = "unique:brands,id,{$brandId}"; } else { // 新增场景:全表唯一校验 $nameRules[] = 'unique:brands'; } return [ 'name' => $nameRules, ]; } /** * 自定义校验错误提示,可按自身业务调整 */ public function messages() { return [ 'name.required' => '品牌名称不能为空', 'name.unique' => '已存在同名品牌', ]; } }
方案优势
- 场景判断准确率高:和Laravel资源路由的设计完全匹配,新增路由(
POST /brands)不会携带brand路由参数,更新路由(PUT/PATCH /brands/{brand})必然携带品牌ID,不会出现场景误判。 - 兼容性强:无论是否开启路由模型绑定,都能正常获取到目标品牌ID,不需要额外做适配;如果实际项目的路由参数名不是
brand,只需要修改$this->route('xxx')中的参数名为实际配置的参数名即可。 - 维护成本低:后续要调整name字段的校验规则(比如追加最大长度限制、格式校验),只需要在基础规则数组里修改即可,不需要重复维护两套规则。
注意:不要用请求方法(POST/PUT)做场景判断,一旦出现特殊接口用POST方法做更新操作的场景,会直接导致校验规则错配。
内容的提问来源于stack exchange,提问作者ManiMuthuPandi
相关产品推荐
相关产品推荐

