ThinkPHP怎样处理JSON请求数据_JSON数据处理方法【教程】
作者:WarmHope
时间:2026-07-07
浏览:0
ThinkPHP6默认不解析application/json请求体,需用$request->json()替代input()获取JSON字段;不同版本对withJson方法支持不一。模型中处理JSON字段应手动json_encode并声明$json属性,否则易致乱码或解析错误。
ThinkPHP 6 默认不解析 application/json 请求体,$request->input() 拿不到 JSON 字段——这不是你写错了,是框架默认行为。

为什么 $request->input('key') 总是 null?
因为 TP6 只对 application/x-www-form-urlencoded 和 multipart/form-data 自动解析请求体,application/json 被完全跳过。即使前端发的是 {"name":"张三"},$request->input('name') 也返回 null 或空字符串。
$request->getInputData()能看到原始字符串,说明数据已到达 PHP 层$request->post()同样为空,因为它底层依赖input()的解析结果- Content-Type 必须严格为
application/json(不能带; charset=utf-8,某些版本会失败)
用 $request->json() 替代 input() 读顶层或嵌套字段
$request->json() 是 TP 封装的 JSON 解析入口,它自动读取 php://input、json_decode 并缓存结果,比手动 file_get_contents('php://input') 更安全高效。
$request->json('name')→ 返回"张三"$request->json('tags.0')→ 支持点号路径,取"a"$request->json()(无参)→ 返回完整关联数组- JSON 格式错误时返回
null,不会抛异常,需自行判断:if ($request->json() === null) { /* log or fallback */ }
$request->withJson(true) 和 $request->json(true) 怎么选?
这是触发 JSON 解析的关键动作,但版本差异大,不能混用:
- TP6.1+ 推荐在中间件或控制器开头调用
$request->withJson(true),它会让后续所有input()、param()、post()都从已解析的 JSON 中取值(注意:只是“可用”,不是“自动生效”) - TP6.0 不支持
withJson(),必须显式调用$request->json(true),它等价于执行一次解析并返回结果,但不改变input()行为 $request->input('user.id', '', 'json')这种写法无效——第三个参数只控制数据来源(get/post/param),不触发 JSON 解析
模型里存/取 JSON 字段容易踩的坑
数据库字段类型是 JSON 或 TEXT 都行,但 PHP 层处理逻辑完全不同:
- 写入前必须
json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),否则中文乱码、斜杠被转义 - 读取时若想自动转成数组/对象,模型中必须声明
protected $json = ['config', 'extra'];,否则字段仍是字符串 Db::table()直接查绕过模型,$json完全不生效;where('data->status', 1)仅 MySQL 5.7+ 且字段类型为JSON才支持,TEXT会 SQL 报错- 别和
$withAttr共用同一字段,否则可能重复json_decode导致返回null
最常被忽略的一点:JSON 解析是否成功,不能只看有没有报错,得检查 json_last_error() 或直接 var_dump(gettype($data->field)) 确认它是 array/object 还是 string。
作者最新文章
Photoshop图层阵列怎么做?复制多个图层并整齐排列
2026-09-22 16:42
3dmax动画技巧总结:动画制作步骤与渲染视频教程
2026-09-22 14:47
思源笔记
2026-09-16 17:42
在线PDF转TXT操作步骤与乱码排查指南
2026-09-04 13:02
PDF加水印后如何检查显示效果?在线工具操作步骤与避坑指南
2026-09-03 13:02
热门文章
更多
精品专题
更多
Mac软件
更多
WINDOWS
更多


































