ThinkPHP6中安全获取GET/POST参数应使用input()函数而非$_GET/$_POST,支持来源指定、默认值、类型转换(如/s、/d)及过滤,避免混用导致参数误取。
如何在控制器里安全获取 GET/POST 参数
ThinkPHP6 默认通过
函数统一读取请求参数,不建议直接操作
或
—— 它们未经过框架过滤、无法自动处理数组嵌套、也不支持默认值和类型转换。
常见错误是写成
却没指定来源,结果在 POST 请求里误取到 GET 中同名参数;或者用
想批量取子数组却漏了末尾点号,导致取不到数据。
:自动从 GET/POST/PUT/PATCH 中查找,优先级为 POST > GET
:强制只从字符串上下文取,等价于
:取
并转为整型,非法值返回 0
:明确声明要数组,即使前端传的是字符串也不会报错,而是返回空数组
POST 表单含文件时,
不会读取文件字段,需用
为什么不能直接 echo
js
on_encode() 返回 JSON
直接
+
会绕过 ThinkPHP 的响应生命周期:Header 不设 Content-Type、不触发事件、不走中间件、不兼容调试模式下的 Trace 信息输出。线上环境可能因缺少
导致前端解析失败,调试时也看不到日志上下文。
更隐蔽的问题是:当
含中文或特殊字符,而没设 JSON_UNESCAPED_UNICODE,JSON 会被转义成 \uXXXX,前端处理成本上升;若数据含资源(如 GD 图像句柄),
会静默失败返回 false,但你根本收不到警告。
立即学习
“
PHP免费学习笔记(深入)
”;
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
必须用
方法返回,它自动设置 Header、处理编码、兼容调试模式
可追加自定义 Header
若需控制 JSON 选项(如不转义 Unicode),应继承
自定义类,而非硬编码
不要在
前调用
,否则会触发「headers already sent」错误
统一返回结构的推荐写法
多数项目需要封装
/
方法,但别在每个控制器里重复写——应该放在基类或使用助手函数。直接在控制器里拼关联数组容易漏字段、不一致,比如有的写
,有的写
,前端就得写多套解析逻辑。
ThinkPHP6 支持全局响应输出格式配置,但仅适用于简单场景;复杂业务仍建议封装一个标准响应方法,确保
、
、
字段稳定,且
表示成功(避免用 HTTP 状态码替代业务码)。
在
中添加:
调用时:
错误响应建议带
区分类型(如 400 参数错、401 未登录、500 服务异常),而非全用 -1
不要把敏感字段(如密码、token)塞进
再交给
—— 应在组装前就过滤
POST 数据为空或 JSON 格式时怎么处理
当接口被设计为接收 JSON Body(如前端用
),
默认不会解析原始 JSON,会返回空字符串或 null。这是最常被忽略的兼容点。
ThinkPHP6 的
对 JSON 请求体的支持依赖于
类是否已调用
,而该方法只在特定时机(如首次调用
)触发。手动调用
也不能保证正确解包。
检测是否为 JSON 请求:
,然后用
获取解码后的数组(
表示深度递归转换)
想统一处理所有来源,可重写控制器构造函数,在开头执行:
注意:表单提交(
)和 JSON 提交不能混用,后端无法同时解析两者
若用 Nginx 反向代理,确认没开启
,否则
等头可能被丢弃,影响
判断
实际项目中,参数校验和 JSON 返回往往连在一起 —— 但别把验证逻辑塞进响应封装里。校验应前置(用 Validate 或注解),响应只负责格式化。最容易被跳过的,是 Content-Type 的自动推导和 JSON 编码异常的兜底处理。
input()$_GET$_POSTinput('id')input('data.')input('name')input('name/s')input('name', '', 'htmlspecialchars')input('user.id/d')user[id]input('list/a')input()request()->file()echo json_encode($data)exitContent-Type: application/json$datajson_encode()json($data)json($data)->header(['X-Api-Version' => 'v1'])think\Responsejson_encode()json()header()success()error()['code'=>0,'msg'=>'ok','data'=>$d]['status'=>true,'message'=>'OK']codemsgdatacode=0app\BaseController.phpprotected function success($data = [], $msg = 'ok', $code = 0) { return json(['code' => $code, 'msg' => $msg, 'data' => $data]); }return $this->success(['id' => 123], '创建成功');code$datasuccess()fetch({method:'POST', headers:{'Content-Type':'application/json'}, body:JSON.stringify(...)})input()input()RequestgetInputData()param()input('', '', false)request()->isJson()request()->json(true)true$this->mergeInput(); // 自动合并 JSON Body 到 input 数据源application/x-www-form-urlencodedunderscores_in_headers offX-Requested-WithisAjax()