可复用自定义验证器必须是独立PHP类：类名以Validator结尾，继承yii\validators\Validator，重写validateAttribute()，init()首行调用parent::init()，参数声明为public属性，客户端验证需实现clientValidateAttribute()，when与skipOnEmpty须显式配置。
想让一个自定义验证器在多个模型里复用，关键不是“写出来”，而是“设计得对”——类名、继承关系、参数声明、初始化逻辑这四点没做对，复用就会失败或静默失效。
独立验证类是复用的唯一可靠方式
内联验证器（匿名函数）写在哪就只能在哪用，没法跨模型。真正可复用的，必须是独立 PHP 类：
- 类名严格以 Validator 结尾，比如
EmailDomainValidator或IDCardValidator，否则 Yii 自动加载机制找不到它 - 必须继承
yii\validators\Validator，不能只实现接口或随便写个普通类 - 必须重写
validateAttribute()方法，validate()不会被框架调用，写了也无效 - 在
init()中第一行调用parent::init()，否则$this->message、$this->on等基础属性为空，后续报错或配置都不可用
参数要通过 public 属性声明，不能靠 $params 解析
如果你希望验证器支持不同严格等级（如宽松匹配邮箱后缀），不要在方法里解析 $params 数组，而是提前声明为类属性：
- 写成
public $strict = true;，而不是在validateAttribute()里去$params['strict'] ?? false - 在模型 rules() 中直接传值：
['email', 'EmailDomainValidator', 'strict' => false] - 这样参数能被自动注入，且支持 IDE 提示、类型检查和规则合并（比如多个规则共用同一验证器实例）
客户端验证要单独实现 clientValidateAttribute()
复用不只发生在服务端。如果表单启用了客户端 JS 校验（比如 ActiveForm 的 enableClientValidation），光有服务端逻辑不够：
- 必须实现
clientValidateAttribute()方法，返回一段合法 JavaScript 字符串 - 注意引号转义：PHP 里双引号字符串中，JS 的单引号要保留，双引号需转义，例如
"if (value.indexOf('@example.com') === -1) { messages.push('域名必须为 example.com'); }" - 不实现该方法，前端失去实时反馈，但服务端仍校验——看起来“复用成功”，实则体验断裂
when 和 skipOnEmpty 的行为必须显式协调
多个模型使用同一验证器时，触发条件很可能不同。不能依赖默认值：
-
skipOnEmpty默认为true，但若某模型要求空字段也要校验（如“选了城市就必须填区号”），就得明确设'skipOnEmpty' => false -
when是前置开关：只要它返回false，整条规则跳过，skipOnEmpty就不执行。所以组合使用时，when控制“是否进验证器”，skipOnEmpty控制“进了之后空值怎么处理” - 推荐写法：
['phone', 'PhoneValidator', 'when' => fn($m) => $m->contactType === 'mobile', 'skipOnEmpty' => false]，语义清晰且跨模型可复用
