laravel自定义验证规则必须在appserviceprovider的boot()中注册，闭包规则需显式调用$fail()，对象规则须实现dataawarerule接口才能访问全部请求数据，字符串规则名与对象实例不可混用。
直接说结论：Laravel 自定义验证规则不是“要不要做”，而是“必须选对方式”——用错方法会导致规则不生效、报 Method does not exist、或在 FormRequest 里根本进不了 passes()。
为什么 Validator::extend() 在 AppServiceProvider 外注册就失效
因为 Validator 实例由服务容器在 boot() 阶段才构建完成。如果把 Validator::extend() 放进 register() 方法，或者写在某个中间件、命令类里，Validator 还没被初始化，调用就会失败。
- 必须只在
app/Providers/AppServiceProvider.php的boot()方法内注册 - 不能依赖
$this->app或其他未就绪的服务来构造规则逻辑 - 闭包参数顺序不能错：
function ($attribute, $value, $parameters, $validator)，漏掉$validator就拿不到请求上下文 - 错误消息必须在
resources/lang/zh_CN/validation.php的custom键下配好，否则 fallback 到英文或空字符串
new ValidPhoneNumber 和 'phone_zh' 字符串规则混用会出什么问题
两者注册和调用机制完全不同，强行混用等于让 Laravel 去找一个不存在的字符串规则名，或者把对象当字符串解析，最终抛出 Call to a member function extend() on null 或 Undefined index: phone_zh。
-
new ValidPhoneNumber是对象实例，必须出现在规则数组里作为元素，如['required', new ValidPhoneNumber] -
'phone_zh'是字符串规则名，只能用于管道语法：'phone' => 'required|phone_zh'，不能放进数组里当值用 - 同一个规则名（如
phone_zh）既用Validator::extend()注册，又试图用new PhoneZh调用，Laravel 不识别这种“双轨制” - FormRequest 中若想用字符串规则，必须确保它已全局注册；若用对象规则，需正确
use并实例化
闭包规则里 $fail() 必须显式调用，否则验证永远通过
闭包规则没有自动失败机制，return false 或直接 return 完全无效，Laravel 会当作校验通过处理——这是最隐蔽也最常踩的坑。
- 闭包签名固定为三个参数：
($attribute, $value, $fail)，少一个就收不到$fail回调 - 所有失败分支都必须调用
$fail('提示信息')，哪怕只是$fail(':attribute 不合法') - 不能在闭包里 throw Exception，那会崩掉整个请求，而不是触发验证失败重定向
- 闭包无法访问
$request->all()，如需跨字段比较（比如确认密码），得改用DataAwareRule或FormRequest::withValidator()
Rule 类里访问全部请求数据要实现 DataAwareRule
默认 Rule 接口只给单个字段值，想读取 password_confirmation 或判断 role === 'admin' 是否允许填 salary，必须主动声明支持数据感知。
- 在规则类里
use Illuminate\Contracts\Validation\DataAwareRule; - 实现
setData($data)方法并保存到属性，例如：$this->data = $data; -
passes()中就能用$this->data['password_confirmation']做比对 - 不实现该接口却硬写
$this->data，运行时是null，不会报错但逻辑永远走不通 - 这种规则不能用字符串语法调用，只能以对象形式传入规则数组
真正容易被忽略的是：Rule 类的 message() 方法里，:attribute 占位符能自动替换字段中文名，但前提是验证属性映射已配置（attributes() 或语言文件），否则还是显示 phone 而不是“手机号”。这个细节一漏，前端报错就全是英文或字段名，用户根本看不懂。
