ThinkPHP 的 param() 方法默认返回按优先级合并 GET、POST、PUT、DELETE、PATCH 和路由变量的关联数组，后覆盖前；对未提交字段返回 null，提交为空则返回空字符串 ''；不解析 application/json，需手动处理。
param() 方法到底返回什么类型的数据
ThinkPHP 的 param() 方法默认返回一个关联数组，但它不是简单地把所有参数拼一起——它会按优先级合并 GET、POST、PUT、DELETE、PATCH 和路由变量（route），且后面覆盖前面。比如 URL 带 ?id=1，表单 POST 也传了 id=2，最终 param('id') 拿到的是 2。
常见错误现象：param('id') 拿不到 URL 上的值，其实是 POST 数据里也有同名字段，把它盖掉了；或者用了 get() / post() 单独取，反而绕过了这个合并逻辑。
- 要取原始 GET 参数，用
request()->get('id')，别依赖param() - 想只取路由参数（比如
/user/:id中的id），用request()->route('id') -
param()不区分大小写键名，但实际开发中建议统一小写，避免在不同环境行为不一致
为什么 param('name') 有时返回 null，有时是空字符串
这和参数是否“存在”以及“是否为空值”有关。param() 对于未提交的字段返回 null，对提交了但值为空（如 <input name="name" value="">）则返回空字符串 ''。这不是 bug，是设计如此——ThinkPHP 认为“没传”和“传了但为空”语义不同。
使用场景：做必填校验时，if (is_null($request->param('name'))) 表示字段压根没出现，而 if ($request->param('name') === '') 表示用户主动清空了输入框。
立即学习“PHP免费学习笔记（深入）”；
- 安全起见，校验非空应同时判断：
empty($request->param('name'))不够准，因为它把0、'0'、false都当空 - 更稳妥写法：
$name = $request->param('name', '')显式设默认值，再用trim($name) === '' - 如果前端用 JSON 提交（
Content-Type: application/json），param()默认不解析，得先调request()->json()
param() 在 RESTful 接口里容易漏掉 PUT/PATCH 的数据
浏览器原生表单不支持 PUT 或 PATCH 方法，所以很多 RESTful 接口靠伪造（如加 _method=PUT）或前端发 JSON 实现。这时候 param() 能否取到数据，取决于请求头和 ThinkPHP 的配置。
关键点：ThinkPHP 默认只从 application/x-www-form-urlencoded 和 multipart/form-data 中解析 PUT/PATCH 数据，遇到 application/json 会跳过，直接返回空。
- 确认请求头：
Content-Type: application/json时，必须手动解析：json_decode($request->getContent(), true) - 若坚持用
param()，可在中间件里提前调用$request->parseParams()，但需确保已读取原始 body - 别在控制器开头就多次调
param()—— 它内部缓存结果，但首次调用前若 body 已被其他操作读过（如getContent()），可能导致后续解析失败
性能与兼容性：param() 和 input() 有什么区别
input() 是更底层的函数，它不走合并逻辑，也不自动处理路由变量，只从指定来源（如 input('get.id')）取值，开销略小；param() 是封装好的“智能取值”，适合常规 Web 表单场景，但多了一层合并判断。
兼容性影响：ThinkPHP 6.0+ 中 param() 默认开启“严格模式”（app.request.param_filter 开启时会过滤非法键名），而 input() 更接近裸数据，适合做日志记录或调试。
- 高频接口（如 API 网关层）建议用
input()明确指定来源，避免隐式合并带来的不确定性 - 需要兼容老项目（TP5.x）时注意：
param()在 TP5 中不包含路由变量，TP6 才加入，升级后可能意外拿到路由值 - 别在循环里反复调
param()取同一字段——它内部有缓存，但反复调用仍比直接赋值变量慢
最常被忽略的一点：如果你重写了 Request 类或用了自定义中间件修改了 param 行为，param() 的结果可能和文档描述不一致。调试时优先看 request()->get()、request()->post()、request()->route() 各自返回什么，再反推 param() 的合并结果。
