ThinkPHP验证器代码重复编写_使用自定义验证规则类优化

# 验证逻辑混在业务代码里，注定是场灾难 重复写 `validate` 数组，或者到处 `Validate::make()`，本质上是把校验逻辑和业务逻辑搅在了一起。今天不改，明天不改，等哪天手机号格式规则一变——比如要加区号校验——你就得满世界找哪里写漏了。七个地方改了六个，剩下一个静悄悄地在生产环境里埋雷。 ## 验证规则写在每个控制器里，改一个要改七八处 怎么办？换个写法。把共用规则抽成独立类，继承 `thinkValidate`。在 `app/validate/` 下新建 `UserValidate.php`，在里面定义 `rule`、`message`、`scene`。控制器里只写一句话：`$this->validate($data, 'UserValidate.login')`，再也不拼数组。 这里有个常见坑：`scene` 必须显式定义。如果不定义，`scene('login')` 会静默失败——不报错、也不校验。这就像写了门禁卡权限，没录入卡号，门不开但也不提示你，排查起来够呛。 ## 自定义规则函数名没注册，调用就报 “method not exists” 很多新手栽在这个问题上：写了个 `checkIdCard` 方法，在 `rule` 里直接写 `'id_card' => 'checkIdCard'`。但 ThinkPHP 不认——它只认内置规则和 `Validate` 类里通过 `extend` 注册过的 public 方法。 解决方式其实很清晰： - 自定义方法必须声明为 `public`，且参数完整：`public function checkIdCard($value, $rule = '', $data = [], $field = '')` - 在类的 `__construct()` 或 `init()` 里调用 `$this->extend('id_card', 'checkIdCard')` ，第一个参数才是规则别名 - 规则字符串里仍然写 `'id_card'`，不是函数名 - 千万别在 `rule` 数组里写 `'id_card' => [$this, 'checkIdCard']` 这种函数调用表达式——序列化会直接炸掉 ## 验证器里用 `in` 规则查数据库，一并发就卡住 `'status' => 'in:1,2,3'` 这种写法没问题，数据都写死在规则里。但如果你写成 `'category_id' => 'callback:checkCategoryExists'`，而 `checkCategoryExists` 里又去执行 `Db::name('category')->where(...)->find()`，每次验证都查一次库——平时跑着没事，QPS 一上去，整条请求链路都会被拖垮。 改造方案： - 数据库校验类规则必须加缓存，用 `Cache::remember()` 包住查询结果，过期时间设 10 分钟 - 更优的解是预加载：在验证器 `__construct()` 里一次性查完所有合法 `category_id`，存成私有属性，回调时只做 `in_array` 判断，连库都不碰 - 还有一个绝对红线：禁止在验证规则里做 insert/update 操作。ThinkPHP 验证阶段不支持事务回滚，万一写了一半崩了，脏数据就留在数据库里了 ## 不同模块用同一套验证逻辑，但提示语要本地化 后台和小程序都用同一个 `UserValidate`，但后台提示“用户名不能为空”，小程序得说“请填写昵称”。如果硬编码写死 `message` 数组，要么复制类，要么运行时动态覆盖——两种都是灾难。 正确思路是： - 不在验证器类里写死 `message`，改用语言包：`'username.require' => ':attribute 不能为空'` - 把 `:attribute` 替换成字段别名，通过 `alias` 属性统一管理：`protected $alias = ['username' => '昵称']` - 多语言切换靠 `Lang::range()` 加载对应语言包，验证器实例自动读取当前语言环境 - 但要注意：如果用了 `scene`，`alias` 和 `message` 必须在 scene 定义之后再设置，否则会被 scene 里的配置覆盖 最后提一个容易被忽视的细节：验证器实例的生命周期。它不是单例，每次 `Validate::make()` 都新建对象。所以 `init()` 里做的预加载、缓存绑定，必须确保在首次校验前完成，而不是依赖构造函数顺序——这个顺序问题踩过坑的人都知道有多隐蔽。