ThinkPHP6.x请求与响应：在控制器中获取GET/POST参数并返回规范的JSON数据-ThinkPHP-PHP中文网

thinkphp6中安全获取get/post参数应使用input()函数而非$_get/$_post，支持来源指定、默认值、类型转换（如/s、/d）及过滤，避免混用导致参数误取。

thinkphp6.x请求与响应：在控制器中获取get/post参数并返回规范的json数据

如何在控制器里安全获取 GET/POST 参数

ThinkPHP6 默认通过 input() 函数统一读取请求参数，不建议直接操作 $_GET 或 $_POST —— 它们未经过框架过滤、无法自动处理数组嵌套、也不支持默认值和类型转换。

常见错误是写成 input('id') 却没指定来源，结果在 POST 请求里误取到 GET 中同名参数；或者用 input('data.') 想批量取子数组却漏了末尾点号，导致取不到数据。

input('name')：自动从 GET/POST/PUT/PATCH 中查找，优先级为 POST > GET
input('name/s')：强制只从字符串上下文取，等价于 input('name', '', 'htmlspecialchars')
input('user.id/d')：取 user[id] 并转为整型，非法值返回 0
input('list/a')：明确声明要数组，即使前端传的是字符串也不会报错，而是返回空数组
POST 表单含文件时，input() 不会读取文件字段，需用 request()->file()

为什么不能直接 echo json_encode() 返回 JSON

直接 echo json_encode($data) + exit 会绕过 ThinkPHP 的响应生命周期：Header 不设 Content-Type、不触发事件、不走中间件、不兼容调试模式下的 Trace 信息输出。线上环境可能因缺少 Content-Type: application/json 导致前端解析失败，调试时也看不到日志上下文。

更隐蔽的问题是：当 $data 含中文或特殊字符，而没设 JSON_UNESCAPED_UNICODE，JSON 会被转义成 \uXXXX，前端处理成本上升；若数据含资源（如 GD 图像句柄），json_encode() 会静默失败返回 false，但你根本收不到警告。

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

必须用 json($data) 方法返回，它自动设置 Header、处理编码、兼容调试模式
json($data)->header(['X-Api-Version' => 'v1']) 可追加自定义 Header
若需控制 JSON 选项（如不转义 Unicode），应继承 think\Response 自定义类，而非硬编码 json_encode()
不要在 json() 前调用 header()，否则会触发「headers already sent」错误

统一返回结构的推荐写法

多数项目需要封装 success() / error() 方法，但别在每个控制器里重复写——应该放在基类或使用助手函数。直接在控制器里拼关联数组容易漏字段、不一致，比如有的写 ['code'=>0,'msg'=>'ok','data'=>$d]，有的写 ['status'=>true,'message'=>'OK']，前端就得写多套解析逻辑。

ThinkPHP6 支持全局响应输出格式配置，但仅适用于简单场景；复杂业务仍建议封装一个标准响应方法，确保 code、msg、data 字段稳定，且 code=0 表示成功（避免用 HTTP 状态码替代业务码）。

在 app\BaseController.php 中添加：

protected function success($data = [], $msg = 'ok', $code = 0) { return json(['code' => $code, 'msg' => $msg, 'data' => $data]); }

调用时：return $this->success(['id' => 123], '创建成功');
错误响应建议带 code 区分类型（如 400 参数错、401 未登录、500 服务异常），而非全用 -1
不要把敏感字段（如密码、token）塞进 $data 再交给 success() —— 应在组装前就过滤

POST 数据为空或 JSON 格式时怎么处理

当接口被设计为接收 JSON Body（如前端用 fetch({method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify(...)})），input() 默认不会解析原始 JSON，会返回空字符串或 null。这是最常被忽略的兼容点。

ThinkPHP6 的 input() 对 JSON 请求体的支持依赖于 Request 类是否已调用 getInputData()，而该方法只在特定时机（如首次调用 param()）触发。手动调用 input('', '', false) 也不能保证正确解包。

检测是否为 JSON 请求：request()->isJson()，然后用 request()->json(true) 获取解码后的数组（true 表示深度递归转换）
想统一处理所有来源，可重写控制器构造函数，在开头执行：
```
$this->mergeInput(); // 自动合并 JSON Body 到 input 数据源
```
注意：表单提交（application/x-www-form-urlencoded）和 JSON 提交不能混用，后端无法同时解析两者
若用 Nginx 反向代理，确认没开启 underscores_in_headers off，否则 X-Requested-With 等头可能被丢弃，影响 isAjax() 判断