ThinkPHP5控制器中怎么使用验证器_控制器数据验证【教程】-ThinkPHP-PHP中文网

thinkphp5控制器中调用validate()需注意参数顺序、返回值判断及批量验证等细节：成功返回true，失败返回错误字符串，须用true !== $result判断；开启批量验证需设置protected $batchvalidate = true；场景名须严格匹配如'user.add'；自定义规则需在$rule中显式绑定且方法命名规范。

thinkphp5控制器中怎么使用验证器_控制器数据验证【教程】

控制器里直接调用 `validate()` 就行，但得注意参数顺序和返回值判断

ThinkPHP5 的控制器类（继承 think\Controller）自带 validate() 方法，这是最轻量、最常用的方式。它不是“必须配验证器类才能用”，而是支持三种用法：传验证器类名、传规则数组、甚至传规则+提示语数组——但三者不能混用。

常见错误是把规则写成字符串却没传第三个参数，结果提示语全丢；或者没检查返回值类型，直接当布尔用，导致报错或静默失败。

$this->validate($data, 'User')：使用 app\index\validate\User 验证器类（自动加载）
$this->validate($data, ['name'=>'require|alpha', 'email'=>'email'])：临时规则，无提示语，用系统默认
$this->validate($data, ['name'=>'require'], ['name'=>'用户名不能为空'])：手动指定提示语，适合简单表单或快速调试

注意：validate() 成功时返回 true，失败时返回具体错误信息字符串（不是数组），所以必须用 true !== $result 判断，而不是 !$result ——否则空字符串、'0' 等假值也会被误判。

批量验证要显式开启 `$batchValidate = true`，否则只报第一个错

默认验证遇到第一个字段失败就终止，不继续校验其余字段。用户填了 5 个错项，你只告诉人家“邮箱不对”，体验很差。开启批量验证后，getError() 返回的是关联数组，键为字段名，值为错误提示。

这个开关只能在控制器类级别设置，不能在单次 validate() 调用中动态传参（V5.1.15+ 之前尤其要注意）。

在控制器顶部加：protected $batchValidate = true;
开启后，$result 仍是字符串（第一个错误）或数组（全部错误），但 $this->validate(...) 内部已启用批量模式
如果用独立 Validate 实例，应调用 $validate->batch()->check($data)

容易踩的坑：改了控制器属性但忘了清缓存，或在中间件/基类里覆盖了该属性，导致开关失效。

验证场景（`scene`）必须写对命名，否则规则不生效

验证器类里的 protected $scene 是个白名单机制，不是“启用某几条规则”，而是“只允许验证这些字段”。比如定义了 'add' => ['name', 'email']，但数据里带了 'password'，即使验证器规则里写了 'password' => 'require'，它也不会被检查。

调用时格式必须严格：'User.add'（类名 + 点 + 场景名），中间不能有空格，大小写敏感。漏点、写成 UserAdd 或 user.add 都会 fallback 到默认场景（即所有规则）。

场景名建议全小写，避免大小写混淆
控制器中传参：$this->validate($data, 'User.add')
验证器里没定义该场景？TP5 不报错，但按默认规则走 —— 这是静默陷阱

自定义验证方法和规则要注册到验证器类里，不能只写函数

写了个 isDate($value) 方法，放在验证器类里，但规则写成 'birthday' => 'isDate' 却不生效？因为 TP5 不会自动扫描类方法，必须通过 protected $rule 显式绑定，且方法名需符合命名规范（首字母小写，驼峰转下划线）。

更稳妥的做法是继承 think\Validate 并重写 check()，或使用 extend 注册全局规则（推荐）。但注意：自定义规则函数的返回值必须是布尔型，且不能抛异常，否则验证中断。

正确注册方式：protected $rule = ['birthday' => 'date|isDate']，同时类中存在 protected function isDate($value)
若规则逻辑复杂（如查库去重），建议用 callback 类型：'username' => 'callback:checkUsernameExists'
回调函数必须是控制器或验证器类中的 public 方法，且接收 $value, $rule, $data, $field 四个参数

最常忽略的一点：自定义方法里用了 Db:: 或模型查询，但没处理事务或异常，导致验证失败时数据库状态异常。验证器应尽量保持无副作用。