Yii2自定义验证规则支持通过rules()传入外部参数（如'context'、'whitelist'），在验证方法中通过$params读取，可动态控制逻辑；需避免与内置键冲突，结合on场景和skipOnEmpty等选项精准控制执行时机。
Yii2 自定义验证规则支持接收外部参数，这在需要动态控制校验逻辑（比如根据用户角色、请求来源或配置项切换验证条件）时非常实用。关键在于正确声明参数并在验证方法中读取。
在 rules() 中传入自定义参数
Yii2 允许在规则数组中以键值对形式传入任意参数，这些参数会自动作为 $params 数组传给验证方法：
- 参数名不能与内置键（如
on、skipOnEmpty、message等）冲突，否则会被框架覆盖或忽略 - 建议使用语义清晰的键名，例如
'minLevel'、'allowNull'、'context' - 示例：要求
status字段仅在管理员操作时允许值为'draft'
Model 中写法：
public function rules()
{
return [
['status', 'validateStatus', 'context' => 'admin'],
['status', 'validateStatus', 'context' => 'user'],
];
}
public function validateStatus($attribute, $params)
{
$allowed = ['published', 'archived'];
if ($params['context'] === 'admin') {
$allowed[] = 'draft';
}
if (!in_array($this->$attribute, $allowed)) {
$this->addError($attribute, '状态不合法');
}
}
传递多个参数或复杂结构
可直接传入数组、对象甚至闭包（需注意序列化与作用域），但推荐用简单数组提升可读性与调试便利性：
- 传入关联数组，便于扩展字段级配置
- 避免在
$params中传大对象或资源句柄 - 若需数据库查询或服务调用，应在验证方法内按需获取，而非作为参数传入
示例：带白名单和错误提示模板的校验
['category_id', 'validateInCategory',
'whitelist' => [1, 3, 5, 7],
'message' => '分类 {value} 不在当前业务支持范围内'
],
public function validateInCategory($attribute, $params)
{
$value = $this->$attribute;
if (!in_array($value, $params['whitelist'])) {
$message = str_replace('{value}', $value, $params['message']);
$this->addError($attribute, $message);
}
}
结合场景（on）与外部参数协同使用
场景（on）控制规则是否启用，外部参数控制规则内部行为，二者互补：
- 同一字段在不同场景下复用同一个验证方法，仅通过
$params和$this->scenario分支处理 - 不建议把场景判断逻辑全塞进
$params，应优先用on控制规则加载，再用参数微调
典型组合写法：
['price', 'validatePrice', 'on' => 'create', 'min' => 10],
['price', 'validatePrice', 'on' => 'update', 'min' => 0.01],
public function validatePrice($attribute, $params)
{
$value = $this->$attribute;
if ($value < $params['min']) {
$this->addError($attribute, "价格不能低于 {$params['min']}");
}
}
注意 skipOnEmpty 和 skipOnError 的影响
当字段为空或已有其他错误时，验证方法默认可能不执行 —— 这会影响依赖外部参数的逻辑生效：
- 若参数逻辑必须在空值/错误状态下也运行（如强制校验非空、或做兜底拦截），务必显式设置
'skipOnEmpty' => false和'skipOnError' => false - 否则即使你传了
'context' => 'admin'，方法也可能根本没被调用
