ThinkPHP验证器报错_规则集编写与错误信息格式化-ThinkPHP-PHP中文网

thinkphp验证器错误不显示需调用geterror()获取；自定义规则须public且避免与内置规则同名；中文乱码因文件编码非utf-8或bom存在；scene切换须每次验证前重设。

thinkphp验证器报错_规则集编写与错误信息格式化

ThinkPHP 的验证器默认用 validate 方法触发，但错误信息没出来，大概率是没调用 getError() 或没在模板里正确输出。验证失败后，$validate->validate($data) 返回 false，但错误内容存在内部属性里，不主动取就丢掉了。

写了个 checkMobile 方法，在 rule 数组里写了 'mobile' => 'checkMobile'，但始终走默认的 mobile 内置规则，甚至报 Method not exist 错误。

自定义方法必须是 public 且定义在验证器类中；若用 function 写在外部或 private 声明，会找不到
规则名作为字符串时，ThinkPHP 会优先匹配内置规则（如 email、number），只有内置规则不存在时才查方法——所以别起名和内置规则冲突，比如别叫 date 或 alpha
想强制走自定义方法，写成 'mobile' => ['checkMobile']（数组形式），避免被内置规则劫持

默认 getError() 返回的是纯提示文本，比如 "用户名不能为空"，但实际需要 "用户名：不能为空" 或支持 i18n 占位，得靠 message 配置干预。

字段级提示优先级最高：在 rule 中同字段配 message，例如 'name|用户名' => 'require|alphaNum'，竖线后面的内容就是字段别名，会被自动注入到提示中
全局统一前缀不推荐硬改源码，可用 appendRuleMessage 扩展，但更稳的方式是在控制器里手动组装：array_map(fn($msg) => "【用户】{$msg}", $validate->getError())
如果用了 think-validate 独立包（非框架内置），message 数组键名必须和 rule 字段完全一致，包括点号层级（如 'user.email' 对应 'user.email' => '邮箱格式错误'）

同一个验证器类，scene('edit') 和 scene('add') 切换后，错误信息还是旧场景的，或者字段校验没按预期跳过。

scene 必须在 validate() 调用前设置，且每次验证前都要重新 set——它不是链式调用的“状态”，而是临时覆盖规则集
常见错误：先 $v->scene('edit')->validate($data)，再直接 $v->validate($otherData)，第二次没设 scene，就会沿用上次的规则缓存（ThinkPHP 6.0+ 已修复，但低版本仍存在）
安全做法是每次验证都显式重置：$v->removeScene()->scene('add')->validate($data)，或干脆 new 一个新实例

验证器的规则集本质是运行时动态合并的数组，不是声明即固化的东西。最容易被忽略的是：scene 切换不等于规则重载，message 注入依赖字段别名语法，而自定义方法的触发时机比文档写的更“挑剔”。