ThinkPHP控制器怎么接收PUT请求_ThinkPHPRESTful接口介绍【介绍】-ThinkPHP-PHP中文网

thinkphp 5.1 的 $request->put() 返回空是因为 php 原生不解析 put 请求体，$_put 不存在；需根据 content-type 手动读取 php://input 并解析 json 或表单数据，同时确保 web 服务器与路由支持 put 方法。

thinkphp控制器怎么接收put请求_thinkphprestful接口介绍【介绍】

ThinkPHP 5.1 默认不自动解析 PUT 请求体，直接调用 $request->put() 会返回空数组，必须手动处理 php://input 流才能拿到参数。

为什么 `$request->put()` 拿不到数据？

因为 PHP 的 $_PUT 超全局变量根本不存在，框架的 put() 方法依赖底层是否已解析原始请求体。而 Apache/Nginx 默认只对 POST 做 application/x-www-form-urlencoded 或 multipart/form-data 解析，PUT 请求的 body 不会被自动注入到任何超全局变量中。

常见错误现象：$request->put('id') 返回 null，$request->param('id') 也为空，但用 Postman 发送 PUT 时明明带了 {"id":123} 或 id=123。

PUT 请求体类型决定解析方式：如果是 application/json，需 json_decode(file_get_contents('php://input'), true)
如果是 application/x-www-form-urlencoded，需 parse_str(file_get_contents('php://input'), $data)
ThinkPHP 的 $request->put() 仅在你提前调用过 $request->put($data) 手动注入后才有效

如何正确接收 `application/json` 类型的 PUT 参数

这是 RESTful 接口最常用的 PUT 场景，比如更新用户资料。不能依赖 input('put.id') 或 $request->post('id')，它们都失效。

实操建议：

先判断请求方法：if ($request->isPut()) { ... }
读取原始输入：$raw = file_get_contents('php://input');
安全解码 JSON：$data = json_decode($raw, true) ?: [];（加 ?: [] 防止 null 导致报错）
可选：用 $request->put($data) 注入后，后续就能用 $request->put('name') 单字段取值了

示例片段：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

public function update($id)
{
    $request = request();
    if (!$request->isPut()) {
        return json(['code' => 405, 'msg' => 'Method not allowed']);
    }
    $raw = file_get_contents('php://input');
    $data = json_decode($raw, true) ?: [];
    $name = $data['name'] ?? '';
    // 后续业务逻辑...
}

如何兼容 `application/x-www-form-urlencoded` 的 PUT 表单

部分前端库（如旧版 Axios）或测试工具可能以表单格式发 PUT，此时不能当 JSON 解析，否则得到 null。

关键点：

检查 Content-Type 头：$request->header('content-type')
若匹配 application/x-www-form-urlencoded，用 parse_str() 解析
避免直接 file_get_contents('php://input') 后硬 JSON 解，否则会崩
ThinkPHP 的 $request->param() 对这种 PUT 表单完全无效，别试

简写判断逻辑：

$contentType = strtolower($request->header('content-type'));
if (strpos($contentType, 'application/x-www-form-urlencoded') !== false) {
    parse_str(file_get_contents('php://input'), $data);
} elseif (strpos($contentType, 'application/json') !== false) {
    $data = json_decode(file_get_contents('php://input'), true) ?: [];
} else {
    $data = [];
}

容易被忽略的坑：Nginx/Apache 配置与路由限制

即使代码写对，也可能 405 Method Not Allowed —— 这不是 TP 的问题，是 Web 服务器拦截了 PUT。

排查顺序：

Nginx：确认没禁用 limit_except，或显式放开 PUT，例如：limit_except GET HEAD POST PUT DELETE { allow all; }
Apache：确保 mod_rewrite 正常，且 .htaccess 没用 Deny from all 拦掉非 GET/POST
ThinkPHP 路由：RESTful 路由需显式声明，比如 Route::put('user/:id', 'User/update');，不能只写 get 或 post
CSRF：TP5.1 默认开启 CSRF 验证，而 PUT 请求通常不带 token，需在控制器或中间件中关闭：protected $middleware = ['csrf' => false];