ThinkPHP 路由验证支持类名、闭包两种方式,但仅校验 GET/POST 数据,JSON 需中间件解析;推荐用中间件统一处理全格式参数并指定 scene 场景校验。

路由定义时直接绑定验证规则
ThinkPHP 的 Route::rule() 支持在注册路由时传入验证器类或验证规则数组,这是最轻量、最贴近请求生命周期的校验入口。它比控制器里手动调用 validate() 更早触发,能拦截非法参数在进入控制器前就返回错误。
常见错误是把验证器类名写成字符串路径(如 'app\validate\User'),但 ThinkPHP 6+ 要求必须是完整类名(带命名空间)且类已自动加载;写错会报 Class "xxx" not found。
- 正确写法:
Route::rule('user/add', 'index/User/add')->validate('app\validate\User'); - 支持闭包验证:
->validate(function($data) { return !empty($data['name']); }),适合简单逻辑,但不可复用 - 验证失败默认返回 JSON(
400 Bad Request),内容为['code'=>0, 'msg'=>'xxx'],前端需适配该结构 - 注意:该方式只校验 URL 参数和 POST 表单数据,
application/json请求体需额外处理(见下一条)
JSON 请求体无法被 route validate 自动解析
Route::rule()->validate() 默认只读取 input() 中的 $_POST 和 $_GET,对 php://input 中的原始 JSON 不做解析,导致 { "name": "a" } 这类请求始终校验失败或字段为空。
根本原因是 ThinkPHP 的路由验证不接管原始请求体解析,而 JSON 数据需要先经 Request::param() 或中间件解包才能进验证流程。
- 临时方案:在验证器的
scene或rule中用['require', 'number']等基础规则,避免依赖复杂嵌套结构 - 推荐做法:改用「路由中间件」统一处理 JSON 解析 + 验证(见下一条)
- 不要试图在验证器的
__construct()里手动读php://input—— 此时请求体可能已被读取过一次,再读为空
用路由中间件替代 validate() 实现全格式兼容校验
把验证逻辑从路由定义里抽出来,放到中间件中,既能控制执行时机,又能主动解析 JSON、合并参数、统一错误响应,是更可控的做法。尤其适合前后端分离项目。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
关键点在于中间件必须在 Request 初始化后、控制器执行前运行,并且要确保 $request->param() 已包含所有可用字段(包括 JSON 解析结果)。
- 创建中间件:
php think make:middleware CheckForm - 在中间件
handle()中调用$request->param()获取完整参数(TP6+ 默认已解析 JSON) - 手动实例化验证器:
$result = $this->validate($data, 'app\validate\User');,失败则return json(['code'=>0, 'msg'=>$this->error], 400); - 注册到路由:
Route::rule('api/user', 'api/User/save')->middleware('CheckForm'); - 注意中间件顺序:若用了其他中间件(如 CORS、Token),
CheckForm应放在它们之后,否则可能拿不到完整参数
验证器里用 scene 区分不同路由场景
同一个验证器类(如 UserValidate)常被多个路由共用,但字段要求不同:比如添加用户要校验 password,编辑时却不能改密码。硬编码规则会导致冲突,scene 是 ThinkPHP 提供的场景化解决方案。
问题常出在定义了 scene 却没在路由或中间件中显式指定,导致仍走默认规则;或者 scene 名拼写与路由名不一致,白定义。
- 在验证器中定义:
protected $scene = ['add'=>['name','email','password'], 'edit'=>['name','email']] - 路由绑定时指定:
->validate('app\validate\User.add')(注意点号连接) - 中间件中调用:
$this->validate($data, 'app\validate\User', 'edit') - scene 名建议小写、无下划线,避免大小写混用引发 Windows/macOS 兼容问题
真正麻烦的是嵌套验证和自定义验证方法的上下文 —— 它们不会自动感知当前 scene,得在方法里手动判断 $this->scene,这点容易漏掉。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










