当通过application/json类型发送POST请求时，PHP的$_POST超全局变量将为空。这是因为$_POST主要用于解析application/x-www-form-urlencoded或multipart/form-data数据。要正确获取JSON格式的请求体，应使用file_get_contents('php://input')读取原始输入流，并通过json_decode进行解析。本文将详细指导您如何在PHP应用中高效处理JSON POST数据。
理解$_POST与Content-Type的关系
在PHP中，$_POST是一个非常方便的超全局变量，它会自动收集HTTP POST请求中提交的数据。然而，$_POST并非设计用于解析所有类型的请求体。它的主要作用是处理以下两种常见的表单提交类型：
-
application/x-www-form-urlencoded: 这是HTML表单的默认编码类型。当您使用curl命令配合--data-urlencode或--data（不指定Content-Type时默认）发送数据时，数据会被编码成键值对的形式，PHP能够自动解析并填充到$_POST中。
// 当请求Content-Type为 application/x-www-form-urlencoded 时 // curl -X POST 'localhost/api/v1/customers' -H 'Content-Type: application/x-www-form-urlencoded' --data-urlencode 'id=12345' print_r($_POST); // 输出 Array ( [id] => 12345 )
-
multipart/form-data: 当表单包含文件上传时，通常会使用这种编码类型。PHP同样能解析此类请求，并将普通字段放入$_POST，文件信息放入$_FILES。
立即学习“PHP免费学习笔记（深入）”；
然而，当请求的Content-Type设置为application/json时，PHP的CGI/FPM SAPI（服务器应用编程接口）并不会将JSON请求体自动解析并填充到$_POST中。$_POST会保持为空，因为JSON数据不是标准的URL编码表单数据。
获取原始JSON请求体：php://input
要获取application/json类型的POST请求体，我们需要直接读取PHP的输入流。PHP提供了一个特殊的包装器php://input，它允许您访问请求的原始数据。这对于处理非表单数据（如JSON、XML或其他自定义格式）非常有用。
php://input是一个只读流，它允许您读取HTTP请求体。与$_POST不同，php://input在任何Content-Type下都可用，并且不会受到post_max_size限制（尽管内存限制仍然适用）。
实战：处理JSON数据
以下是如何在PHP中接收并解析JSON POST请求的步骤：
- 读取原始请求体: 使用file_get_contents('php://input')函数读取整个原始请求体。
- 解析JSON数据: 使用json_decode()函数将JSON字符串转换为PHP数组或对象。
'success', 'message' => '数据处理成功', 'received_data' => $data]);
} else {
// JSON解码失败
header('HTTP/1.1 400 Bad Request');
header('Content-Type: application/json');
echo json_encode(['status' => 'error', 'message' => '无效的JSON数据', 'error_code' => json_last_error()]);
}
} else {
// Content-Type不是application/json，可能需要处理其他类型或返回错误
header('HTTP/1.1 415 Unsupported Media Type');
header('Content-Type: application/json');
echo json_encode(['status' => 'error', 'message' => '请发送Content-Type为 application/json 的请求']);
}
} else {
// 非POST请求
header('HTTP/1.1 405 Method Not Allowed');
header('Allow: POST');
header('Content-Type: application/json');
echo json_encode(['status' => 'error', 'message' => '只允许POST请求']);
}
?>使用curl发送JSON请求
要测试上述PHP脚本，您可以使用curl命令发送一个application/json类型的POST请求：
curl -X POST 'localhost/api/v1/customers' \
-H 'Content-Type: application/json' \
-d '{"id":"12345", "name": "John Doe"}'当PHP脚本收到此请求时，它将输出类似以下内容：
成功接收到JSON数据：
Array
(
[id] => 12345
[name] => John Doe
)
ID: 12345
{"status":"success","message":"数据处理成功","received_data":{"id":"12345","name":"John Doe"}}注意事项与最佳实践
- 错误处理: 始终检查json_decode()的返回值和json_last_error()。如果JSON字符串格式不正确，json_decode()会返回null，并且json_last_error()会提供错误码。
- 输入验证: 即使JSON数据格式正确，也必须对其中的内容进行严格的验证和过滤，以防止SQL注入、XSS攻击或其他安全漏洞。
- 安全性: 避免直接将用户输入的数据存储或显示，除非经过适当的消毒处理。
- Content-Type检查: 在服务器端检查请求的Content-Type头，确保客户端发送的是预期的JSON数据。如果不是，可以返回415 Unsupported Media Type错误。
- 内存限制: 对于非常大的JSON请求体，file_get_contents('php://input')可能会消耗大量内存。在极端情况下，可能需要考虑流式处理。
- 框架集成: 如果您在使用PHP框架（如Laravel, Symfony等），它们通常提供了更高级、更便捷的方式来访问和验证JSON请求体，通常通过请求对象（e.g., $request->json('key')）来实现。
总结
理解$_POST与application/json请求体处理方式的差异是构建现代Web API的关键。通过file_get_contents('php://input')，PHP开发者可以有效地获取和解析JSON格式的POST数据，从而支持更灵活、更标准化的数据交换。在实际应用中，结合健壮的错误处理和输入验证机制，可以确保您的API安全可靠地处理各种JSON请求。
