ThinkPHP 8.0 注册接口验证需用场景（scene）精准控制字段校验：生成UserValidate类后，必须在$scene中显式声明各场景字段白名单（如'register'=>['name','email','mobile','password']），漏写即不校验；调用时须链式执行scene()→check()，否则场景失效。
你在写 ThinkPHP 8.0 的注册接口，发现用户提交的手机号、邮箱、密码字段在不同场景下要验不同的规则——注册时全都要，登录只要邮箱和密码，修改资料时又允许邮箱为空——但照着文档写完 $scene 却没生效，数据照样全量校验或直接跳过。
生成验证器类：别手敲，用命令行
打开终端，进入项目根目录，执行：
php think make:validate UserValidate
这会自动生成 app/validate/UserValidate.php 文件，含标准命名空间、继承声明和空的 $rule / $message / $scene 属性。手动创建极易出错：文件放错目录（比如丢进 app/controller）、命名空间写成 app\validate\user_validate（小写或下划线）、类名与文件名不一致（UserValidate.php 里写 class userValidate），都会触发 Class not found。
生成后立刻检查文件头三行是否为：
namespace app\validate;
use think\Validate;
class UserValidate extends Validate
立即学习“PHP免费学习笔记（深入）”；
定义规则和错误提示
在 UserValidate.php 的 $rule 属性中填入字段规则，例如：
protected $rule = [
'name' => 'require|alphaNum|max:20',
'email' => 'email',
'mobile' => 'mobile',
'password' => 'require|length:6,20'
];
注意：mobile 规则要求字段值必须在内置 mobile 验证范围内，即符合中国大陆手机号 11 位纯数字格式；若传入 138****1234 带星号或带空格，会直接失败。不要用正则替代，TP8 的 mobile 是强校验。
在 $message 中覆盖默认提示，让前端看得懂：
protected $message = [
'name.require' => '用户名不能为空',
'email.email' => '邮箱格式不正确',
'mobile.mobile' => '手机号格式不正确',
'password.length' => '密码长度需为6~20位'
];
配置多场景：register/login/edit 必须显式声明字段白名单
在 $scene 属性中定义三个场景，每个场景必须完整列出该场景下参与校验的所有字段名，哪怕规则和默认一样也要写进去：
protected $scene = [
'register' => ['name', 'email', 'mobile', 'password'],
'login' => ['email', 'password'],
'edit' => ['name', 'email']
];
漏掉字段=不校验=也不保证它存在。比如 edit 场景没写 mobile，那即使用户 POST 了 mobile 字段，它也不会被校验；但如果你后续代码写了 $data['mobile']，就会触发 PHP Notice。这不是验证器的 bug，是设计使然——场景就是字段白名单，不是“排除列表”。
场景名大小写敏感，'Register' 和 'register' 是两个不同场景，调用时写错就走空场景（即全部字段）。
控制器中调用验证器：三步不能少
方法一：门面方式（推荐）
① 在控制器方法顶部引入验证器类名字符串
② 调用 validate(UserValidate::class) 获取门面对象
③ 链式调用 → scene('register') → batch(true) → check($data)
完整示例：
try {
$result = validate(UserValidate::class)->scene('register')->batch(true)->check($this->request->post());
} catch (\think\exception\ValidateException $e) {
throw new \think\exception\HttpResponseException(json(['code' => 400, 'msg' => $e->getError()]));
}
方法二：手动实例化（适合需要动态改规则）
$v = new \app\validate\UserValidate();
$v->scene('login');
$pass = $v->check($data);
if (!$pass) {
return json(['code' => 400, 'msg' => implode('；', $v->getError())]);
}
关键提醒：validate() 门面返回的是对象，不调 check() 就等于只拿了安检仪没按启动键；scene() 不调用就等于写了航班计划却不登机——字段白名单永远不会生效。
嵌套数组验证：items.*.name 这种写法默认无效
假设用户提交了地址数组：
$data = ['name' => '张三', 'addresses' => [['city' => '北京', 'code' => '100000'], ['city' => '上海']]];
想验证每个 address 的 code 是否为 6 位数字，不能写 rule['addresses.*.code'] = 'number|length:6'——TP8 默认 strict 模式关闭，通配符会被忽略。
正确做法分两步：
第一步：在 $rule 中声明 addresses 字段类型为 array：
'addresses' => 'array'
第二步：启用 strict 模式并在验证器类中添加自定义方法：
$this->strict(true); // 放在构造函数或 check 前
public function checkAddressCode($value, $rule, $data, $field) {
if (!isset($data['addresses']) || !is_array($data['addresses'])) return true;
foreach ($data['addresses'] as $i => $addr) {
if (!isset($addr['code']) || !preg_match('/^\d{6}$/', $addr['code'])) {
$this->fail("第{$i}个地址邮编格式错误");
return false;
}
}
}
然后在 $rule 中绑定：'addresses' => 'array|checkAddressCode'
