在RESTful风格的接口开发中，HTTP PATCH请求常被用来实现资源的部分更新，相比PUT请求需要提交完整资源数据，PATCH只需要提交需要修改的字段即可，能减少不必要的数据传输。PHP本身没有内置直接处理PATCH请求的原生函数，需要通过读取输入流和解析请求数据来完成处理。
PATCH请求的基本特性
PATCH属于HTTP标准方法之一，它的语义是对目标资源进行部分修改。和PUT方法的区别主要体现在数据提交范围上：PUT要求客户端提交资源的完整表示，即使某些字段没有变化也需要一并提交；而PATCH只需要提交需要变更的字段，服务端仅更新对应字段的内容。
在实际的接口交互中，PATCH请求的Content-Type通常使用application/json或者application/x-www-form-urlencoded，开发者需要根据前端传递的数据格式做对应的解析处理。
PHP获取PATCH请求的原始数据
PHP中所有的HTTP请求原始数据（除了GET请求的查询参数）都可以通过php://input输入流获取，PATCH请求的参数也包含在这个输入流中。我们可以通过file_get_contents函数读取这个流的内容，得到原始请求数据。
以下是读取PATCH请求原始数据的示例代码：
<?php
// 读取PATCH请求的原始输入流
$rawData = file_get_contents('php://input');
// 输出原始数据查看内容
var_dump($rawData);
?>
解析不同格式的PATCH请求数据
解析JSON格式的PATCH数据
如果前端传递的PATCH请求Content-Type是application/json，那么读取到的原始数据就是JSON格式的字符串，需要使用json_decode函数将其解析为PHP数组。
示例代码如下：
<?php
// 读取原始输入流
$rawData = file_get_contents('php://input');
// 解析JSON数据，第二个参数true表示返回数组
$patchData = json_decode($rawData, true);
// 校验解析是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
echo json_encode(['code' => 400, 'msg' => '请求数据格式错误']);
exit;
}
// 输出解析后的数据
var_dump($patchData);
?>
解析表单格式的PATCH数据
如果前端传递的是application/x-www-form-urlencoded格式的PATCH数据，原始数据是类似name=test&age=20的字符串，可以使用parse_str函数将其解析为数组。
示例代码如下：
<?php
// 读取原始输入流
$rawData = file_get_contents('php://input');
// 解析表单格式数据
parse_str($rawData, $patchData);
// 输出解析后的数据
var_dump($patchData);
?>
完整的PATCH请求处理示例
以下是一个模拟更新用户部分信息的完整PATCH请求处理示例，包含参数校验、数据更新、响应返回的完整流程：
<?php
// 只允许PATCH请求访问
if ($_SERVER['REQUEST_METHOD'] !== 'PATCH') {
http_response_code(405);
echo json_encode(['code' => 405, 'msg' => '仅支持PATCH请求']);
exit;
}
// 读取并解析PATCH请求数据
$rawData = file_get_contents('php://input');
$patchData = json_decode($rawData, true);
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
echo json_encode(['code' => 400, 'msg' => '请求数据格式错误']);
exit;
}
// 参数校验，确保提交的字段合法
$allowFields = ['name', 'age', 'email'];
$updateData = [];
foreach ($patchData as $key => $value) {
if (in_array($key, $allowFields)) {
// 简单的数据校验，实际项目可根据需求扩展
if ($key === 'email' && !filter_var($value, FILTER_VALIDATE_EMAIL)) {
http_response_code(400);
echo json_encode(['code' => 400, 'msg' => '邮箱格式错误']);
exit;
}
$updateData[$key] = $value;
}
}
// 模拟更新用户数据，实际项目中这里会操作数据库
$userId = 1; // 假设要更新的用户ID
// 这里省略数据库更新逻辑，仅返回更新后的结果
$result = [
'code' => 200,
'msg' => '更新成功',
'data' => [
'user_id' => $userId,
'update_fields' => $updateData
]
];
// 设置响应头并返回JSON结果
header('Content-Type: application/json; charset=utf-8');
echo json_encode($result);
?>
处理PATCH请求的常见注意事项
- 需要先校验请求方法是否为PATCH，避免其他请求方法误触发更新逻辑，可以通过
$_SERVER['REQUEST_METHOD']判断请求方法。 - 解析请求数据时要做好格式校验，避免非法数据传入业务逻辑，尤其是JSON解析失败时要及时返回错误响应。
- 部分更新时要明确允许修改的字段范围，避免用户提交未授权的字段导致数据安全问题。
- 如果接口需要支持多种Content-Type的PATCH请求，需要先通过
$_SERVER['CONTENT_TYPE']获取请求头中的内容类型，再做对应的解析处理。
总结
PHP处理HTTP PATCH请求的核心流程是读取php://input输入流获取原始数据，根据请求的Content-Type解析为对应的PHP数组，再对数据进行校验和业务处理。只要掌握了输入流读取和数据解析的方法，就可以灵活处理各种格式的PATCH请求，满足接口开发中资源部分更新的需求。
PHPPATCH请求HTTP方法RESTful_API修改时间：2026-06-23 20:45:22