Yii2中实现字段间依赖验证需用when选项配合匿名函数，仅当条件满足（如status==='active'）时触发对应规则，并同步配置whenClient保证前后端逻辑一致。
在 Yii2 中，若需让某个字段的验证逻辑依赖于其他字段的值（例如：当 status 为 active 时，expire_date 必须填写且大于当前时间），不能仅靠内置的规则如 required 或 date 独立完成，而需使用自定义验证方法，并在规则中声明依赖关系。
在 rules() 中声明自定义验证并指定 when 条件
最常用且推荐的方式是使用 when 选项配合匿名函数，动态控制某条验证规则是否生效。它天然支持“依赖其他字段”的场景：
-
只在满足条件时触发验证：比如仅当
status === 'active'才校验expire_date -
访问当前模型所有属性：
$model->other_field可直接读取其他字段值 - 避免冗余报错：条件不满足时，该规则完全跳过，不会干扰其他字段验证
示例：
public function rules()
{
return [
// 当 status 是 active 时，expire_date 必须存在且是有效未来日期
[['expire_date'], 'required', 'when' => function ($model) {
return $model->status === 'active';
}, 'whenClient' => "function (attribute, value) {
return $('#mymodel-status').val() === 'active';
}"],
[['expire_date'], 'date', 'format' => 'php:Y-m-d', 'when' => function ($model) {
return $model->status === 'active';
}],
[['expire_date'], function ($attribute) {
if ($this->status === 'active' && $this->expire_date && strtotime($this->expire_date) addError($attribute, '有效期必须是今天之后的日期');
}
}, 'when' => function ($model) {
return $model->status === 'active';
}],
];
}
使用 inline validator（内联验证器）做复合逻辑判断
当验证逻辑较复杂（如多个字段联动、需查数据库、或需同时设置多个错误），适合写成独立的内联方法。注意两点关键细节：
- 方法必须是 public，且接收
$attribute和$params两个参数 - 在
rules()中通过['attribute', 'methodName']引用，并仍可搭配when控制触发时机
示例：
public function rules()
{
return [
[['price', 'discount'], 'validatePriceAndDiscount', 'when' => function ($model) {
return $model->is_on_sale;
}],
];
}
public function validatePriceAndDiscount($attribute, $params)
{
if ($this->price discount) {
$this->addError('discount', '折扣金额不能大于等于商品价格');
}
if ($this->discount addError('discount', '折扣金额不能为负数');
}
}
注意客户端验证同步（whenClient）
服务端的 when 只影响 PHP 层验证，前端表单仍可能提交无效数据。为提升体验，应同步实现 whenClient —— 它是一段 JS 字符串，返回 true/false 决定前端是否启用该规则：
- 使用 jQuery 选择器获取其他字段值（如
$('#form-status').val()） - 确保 HTML 表单字段 ID 与 JS 中一致（默认为
ModelName[attribute]，可用id选项覆盖） - 简单逻辑可内联写；复杂逻辑建议抽离到全局函数中，再在
whenClient中调用
避免常见陷阱
-
不要在 rule 中直接访问 $_POST：应始终通过
$model->xxx读取属性，否则无法兼容批量赋值和测试 -
when 函数里不要修改模型状态：它只用于判断，不是钩子；副作用逻辑应放在
beforeValidate()或自定义验证方法中 - 多个 when 规则之间无执行顺序保证：若 A 规则依赖 B 字段，而 B 字段本身也有 when 验证，需确保 B 的验证先完成（通常 Yii 按 rules 数组顺序执行，但不建议强依赖）
-
数据库字段为空字符串或 null 时注意 == 与 === 区别：PHP 中
'' == 0为 true，建议统一用严格比较
