搞懂php put请求是什么意思？看完这篇就明白了。

发布日期： 2025-09-26 阅读量： 作者： admin

今天搞了搞 PHP 的 PUT 请求，之前一直用 GET 和 POST，感觉也够用了，但最近对接一个接口，对方要求用 PUT，没办法，只能研究一下了。

有点懵。PUT 嘛听着就像是‘放’东西上去，跟 POST 有点像，都是发数据给服务器。但查了查，好像 PUT 更强调是‘替换’或者‘更新’某个已经存在的东西，POST 用途更广，像创建新东西什么的。行，理论先放一边，动手试试。

咋接收数据？

关键是怎么在 PHP 里接收 PUT 过来的数据。我习惯性地试了下 `$_POST`，空的，`$_GET` 更不用说了，那肯定也没有。这就奇怪了，数据发过来了，跑哪儿去了？

后来才发现，得用一个特殊的东西来读，叫 `php://input`。这玩意儿能读取请求里最原始的数据流。接收 PUT 请求发来的数据，得这么写：

$putData = file_get_contents('php://input');

这样，$putData 变量里存的就是对方通过 PUT 请求发过来的所有原始数据了，通常是一串字符串。

拿到原始数据还不行，我得用。这串数据可能是各种格式，最常见的是 JSON 格式，或者是类似 URL 参数那种 `key=value&key2=value2` 的格式。

如果是 JSON，那还好办，直接用 `json_decode` 函数处理一下，就能变成 PHP 的对象或者数组了：

$dataArray = json_decode($putData, true); // true 表示转成数组

如果是那种 `key=value` 格式的字符串，PHP 有个现成的函数 `parse_str` 可以帮大忙：

parse_str($putData, $dataArray);

执行完这句，$dataArray 就变成了一个包含所有参数的数组，跟处理 `$_POST` 差不多了，用起来就顺手多了。之前就遇到过一次，不知道用 `parse_str`，直接读出来是字符串，自己去分割解析，处理起来贼麻烦，这个函数算是救了我一命。

有时候不光要接收，可能还得用 PHP 主动去请求别人的接口，而且也要求用 PUT 方法。这种时候，一般就轮到 cURL 出场了。

用 cURL 发 PUT 请求，大概思路是这样的：

初始化一个 cURL 句柄。
设置请求的 URL。
关键一步： 设置请求方法为 PUT。用 `curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');` 这个选项。
设置要发送的数据。用 `curl_setopt($ch, CURLOPT_POSTFIELDS, $dataToSend);`，$dataToSend 就是你要发的数据，比如 JSON 字符串。
可能还需要设置一些请求头，比如 `Content-Type`。
执行请求，然后获取返回结果。
关闭 cURL 句柄。

具体代码就不贴了，网上搜一下 cURL 发 PUT 请求有很多例子，核心就是设置 `CURLOPT_CUSTOMREQUEST` 为 'PUT'，并且把数据通过 `CURLOPT_POSTFIELDS` 发出去。

所以折腾下来感觉，PUT 这东西，语义上是挺清晰的，就是专门用来更新或者替换服务器上某个特定资源的。比如，更新 ID 为 123 的用户信息，用 PUT 请求 `users/123` 就很符合这个意思。

但实际开发中，老实说，很多人（包括我以前）图省事，更新操作也用 POST 就对付过去了，服务器那边也能处理。规范点用 PUT，接口语义更清楚，特别是做 RESTful API 的时候，也算是个好习惯。这回对接，对方要求了，也就正好学学，把它弄明白了。

PHP 处理 PUT 请求不算复杂，就是要记得从 `php://input` 拿数据，再根据对方发来的数据格式（JSON、表单字符串等）解析一下。发送 PUT 请求主要靠 cURL 设置正确的选项。又get到一个小技能，记录一下。