Validator::extend() 必须在 boot() 中调用，因 Validator 是延迟加载单例，register() 或运行时调用会报空指针；闭包参数为 $attribute、$value、$parameters、$validator，用于字段校验与跨字段验证；需配合 replacer 或语言文件定义提示，避免规则名冲突，复杂逻辑应改用 Rule 类。
直接用 Validator::extend() 注册规则最轻量，但必须在服务容器就绪后执行，否则会报 Call to a member function extend() on null —— 这是新手踩得最多的一坑。
为什么只能在 boot() 里调用 Validator::extend()
Laravel 的 Validator 是延迟加载的单例，只在 boot() 阶段由 ValidationServiceProvider 构建完成。如果写在 register() 或任意其他未初始化的地方：
-
Validator实例根本不存在，extend()就是空指针调用 - 控制器、中间件、命令行里直接调用也会失败——它们不是验证器生命周期的一部分
- 队列任务中若漏掉服务提供者注册，同样静默崩溃
Validator::extend() 闭包的四个参数怎么用
闭包签名是 function($attribute, $value, $parameters, $validator)，别少传或错序：
-
$attribute：字段名，比如'phone'，可用于拼提示语 -
$value：当前字段值，注意它可能是null或字符串，别直接strlen($value)而不判空 -
$parameters：规则里用冒号传的参数，如'phone_zh:13800138000'→$parameters = ['13800138000'] -
$validator：整个验证器实例，可调$validator->getData()拿全部输入，适合跨字段校验（比如确认密码）
示例：校验两个字段之和是否等于指定值
Validator::extend('sumsTo', function ($attribute, $value, $parameters, $validator) {
$expected = (float) array_shift($parameters);
$others = $validator->getData();
$sum = (float) $value + array_sum(array_intersect_key($others, array_flip($parameters)));
return abs($sum - $expected) < 0.01; // 浮点容差
});
错误消息不显示？检查 replacer 和语言文件
仅注册 extend() 不够，Laravel 默认用内置模板生成提示，比如 The :attribute is invalid.。要自定义中文提示，有两个选择：
- 用
Validator::replacer()写内联替换逻辑，适合动态内容（如带参数的提示） - 更推荐：在
resources/lang/zh_CN/validation.php的'custom'数组里加条目：'phone_zh' => ':attribute 必须是中国大陆手机号' - 切勿漏掉
'attributes'配置，否则:attribute插值会显示成英文字段名
规则名冲突和升级风险
命名看着随意，实际影响很大：
- 别覆盖 Laravel 内置规则名，比如
'exists'、'required_if'，会导致行为不可预期 - 避免用下划线开头（如
'_internal_check'），部分版本解析规则时会跳过 - 不要继承或重写
Illuminate\Validation\Validator类——方法签名一变就Declaration must be compatible，且ValidatorFactory创建实例时会失败 - 真正需要复用时，优先抽成
Rule类（php artisan make:rule），而不是把所有逻辑塞进闭包
闭包注册看似简单，但一旦规则逻辑变复杂、要读数据库或调 API，就很难测试和复用。这时候该换 Rule 类了，而不是硬撑着改闭包。
