如何在Laravel中创建自定义exclude验证规则？

更优实现方案 #

方案1：使用Laravel原生的条件规则方法（优先推荐） #

不需要自定义规则，直接用FormRequest自带的when()方法动态添加exclude规则即可，写法符合Laravel的官方规范，足够简洁优雅：

// FormRequest的rules方法中实现
public function rules()
{
    return [
        'biz_type' => 'required|in:1,2',
        'unwanted_field' => [
            'string',
            // 满足指定条件时自动添加exclude规则
            $this->when($this->input('biz_type') == 2, 'exclude'),
            // 复杂条件可以传入闭包判断
            $this->when(function ($request) {
                return $request->user()->is_guest && $request->input('status') == 0;
            }, 'exclude')
        ],
    ];
}

这个方案完全不需要额外自定义逻辑，适配绝大多数场景，性能和兼容性都最好。

方案2：封装可复用的自定义排除规则 #

如果同一个排除条件需要在多个验证场景复用，可以扩展验证器实现自定义规则，不要直接调用request->remove()修改原始请求（会产生副作用，影响后续依赖该参数的逻辑），正确写法如下：

1. 在App\Providers\AppServiceProvider的boot()方法中注册自定义规则

use Illuminate\Support\Facades\Validator;

public function boot()
{
    // 示例：自定义exclude_if_guest规则，访客身份时排除对应字段
    Validator::extend('exclude_if_guest', function ($attribute, $value, $parameters, $validator) {
        // 自定义条件判断
        if (auth()->check() && auth()->user()->role === 'guest') {
            // 调用验证器原生方法标记字段为排除状态，不会修改原始请求
            $validator->excludeAttribute($attribute);
        }
        return true;
    });
}

2. 在规则中直接使用即可：

public function rules()
{
    return [
        'admin_only_field' => 'exclude_if_guest|string',
    ];
}

exclude规则的源码实现位置 #

Laravel验证相关的核心逻辑都在Illuminate\Validation命名空间下，exclude规则的实现位于Illuminate\Validation\Concerns\ValidatesAttributes trait的validateExclude方法：

public function validateExclude($attribute, $value, $parameters)
{
    $this->excludeAttribute($attribute);
    return true;
}

底层逻辑就是调用excludeAttribute()方法将字段标记为待排除，验证完成后调用validated()方法获取结果时，会自动过滤所有被标记的字段，仅会影响验证后的输出结果，不会修改原始请求的参数数据。

原有方案的问题说明 #

• 第一种手动判断添加规则的方案本身逻辑是正确的，使用when()方法优化写法后已经足够优雅，不需要额外改造。
• 第二种直接调用request->remove()的方案不推荐使用，会直接删除原始请求中的参数，如果后续中间件、其他验证规则、控制器逻辑需要用到该参数会出现异常。

内容的提问来源于stack exchange，提问作者hereForLearing