TP6处理PUT请求的核心难点是PHP原生不解析PUT请求体，$_PUT不存在、$request->put()默认为空；必须手动读取php://input，依Content-Type（JSON或表单）解析后注入$request->put($data)方可正常使用字段取值。
TP6 接口处理 PUT 请求更新数据，核心难点不在“怎么发”，而在于“服务端能否正确拿到参数”——因为 PHP 原生不解析 PUT 请求体，$_PUT 不存在，$request->put() 默认返回空。必须手动读取并解析 php://input，再注入或直接使用。
正确接收 PUT 参数（JSON 格式）
这是最常见场景，比如前端用 fetch 或 Axios 发送 { "name": "张三", "email": "zhang@example.com" }。
- 先判断请求方法：
if ($request->isPut()) { ... } - 读取原始输入：
$raw = file_get_contents('php://input'); - 安全解码 JSON：
$data = json_decode($raw, true) ?: [];（?: []防止 null 导致后续报错） - 可选：注入到 Request 对象，方便后续单字段取值：
$request->put($data);，之后就能用$request->put('name')或input('put.name')
兼容表单格式的 PUT 请求
部分工具或旧系统可能发送 application/x-www-form-urlencoded 类型的 PUT 数据（如 name=张三&email=zhang%40example.com）。
- 同样需读取
php://input：$raw = file_get_contents('php://input'); - 手动解析为数组：
parse_str($raw, $data); - 注入后即可统一处理：
$request->put($data); - 注意：不能依赖
$request->post()或input('post.xxx')，它们对 PUT 无效
更新数据的推荐写法
拿到参数后，更新逻辑应遵循 TP6 最佳实践：先查后改再保存，确保模型事件、自动时间戳、过滤字段等功能正常生效。
- 查出记录：
$user = User::find($id);（务必确保 $id 来自可信来源，如路由变量或已校验参数） - 赋值并保存：
$user->save($data);或逐字段赋值后调用$user->save(); - 如需只允许特定字段写入：
$user->allowField(['name', 'email'])->save($data); - 避免直接用静态
update()批量更新，除非明确不需要模型事件且数据已严格校验
注意事项与避坑点
很多问题其实卡在环境或配置上，不是代码本身。
- Web 服务器需支持 PUT 方法：Apache 要启用
mod_rewrite并确认无拦截；Nginx 要在 location 中显式允许PUT，例如limit_except GET POST PUT DELETE { deny all; } - 跨域时，响应头中
Access-Control-Allow-Methods必须包含PUT，且Access-Control-Allow-Headers要精确列出前端实际发送的请求头（如X-Token） - 不要在控制器里反复调用
$model->update()，比如先赋值一次再进 if 判断又调一次——这会导致无意义的重复执行，且update()返回值恒为 true，无法准确判断是否真有变更
