Yii2自定义验证器需匹配框架机制：内联验证器用于轻量逻辑，须用匿名函数或[$this,'method']声明；独立验证类需继承Validator、重写validateAttribute()，类名以Validator结尾；均须用addError()报错，不可return false或throw异常。
Yii2 自定义验证器不是“写个函数就能用”，关键在匹配框架调用机制和生命周期。内联验证器适合字段间简单逻辑，独立验证类适合复用、带参数或需客户端支持的场景。两者都必须通过 addError() 报错，不能 return false 或 throw 异常。
内联验证器：写在 rules() 里的一次性校验
适用于密码确认、字段比对、枚举值限制等轻量逻辑。必须用匿名函数或 [$this, 'methodName'] 形式声明，签名固定为 function($model, $attribute, $params)。
- 字段为空时默认仍会执行——如需跳过，手动加判断：
if ($model->$attribute === null || $model->$attribute === '') return; - 报错必须调用
$model->addError($attribute, $message)，属性名不能写错（比如校验email却往username上 addError） - 示例：检查国家字段只允许 USA 或 Web
['country', function ($model, $attribute) {<br> if (!in_array($model->$attribute, ['USA', 'Web'])) {<br> $model->addError($attribute, 'The country must be either "USA" or "Web".');<br> }<br>}]
独立验证类：可复用、可配参、可前端联动
适合手机号、身份证、自定义格式等通用逻辑。新建类继承 yii\validators\Validator，重写 validateAttribute() 方法。
- 类名必须以
Validator结尾（如PhoneValidator），否则自动加载失败 - 务必在
init()中调用parent::init()，否则$this->message等内置属性未初始化 - 参数通过 public 属性声明（如
public $strict = true;），并在 rules 中传入：['mobile', 'PhoneValidator', 'strict' => false] - 如需支持浏览器端验证，实现
clientValidateAttribute()，返回合法 JS 字符串（注意单双引号转义）
when 和 skipOnEmpty 的配合要点
二者共同决定验证是否真正触发，但作用不同、顺序有别：
-
when是第一道开关：只有它返回 true，验证才会进入下一步 -
skipOnEmpty默认为 true，仅在when为 true 后才生效；若设为 false，则即使字段为空也强制校验 - 典型组合：
'when' => fn($m) => $m->status === 1, 'skipOnEmpty' => false，确保 status=1 时无论空否都校验
常见踩坑提醒
这些错误高频出现，写完建议立刻核对：
- 验证方法没声明为
public，调用静默失败无报错 -
each嵌套 rule 时漏掉子规则 key，应写['rule' => ['integer', 'min' => 1]]，不是['integer', 'min' => 1] -
exist验证中targetAttribute没配对，例如表单字段是senderId，但目标表主键是id，须显式写'targetAttribute' => ['senderId' => 'id'] - 自定义方法校验时忘记加
'skipOnEmpty' => false，导致空值直接跳过，逻辑未执行
