当通过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数组或对象。
<?php // 确保只处理POST请求 if ($_SERVER['REQUEST_METHOD'] === 'POST') { // 检查Content-Type是否为 application/json $contentType = isset($_SERVER["CONTENT_TYPE"]) ? trim($_SERVER["CONTENT_TYPE"]) : ''; if (strpos($contentType, 'application/json') !== false) { // 读取原始JSON请求体 $jsonInput = file_get_contents('php://input'); // 将JSON字符串解码为PHP关联数组 // 第二个参数为 true 表示返回关联数组，否则返回对象 $data = json_decode($jsonInput, true); // 检查JSON解码是否成功 if (json_last_error() === JSON_ERROR_NONE) { // 成功获取并解析JSON数据 echo "成功接收到JSON数据：n"; print_r($data); // 示例：访问数据 if (isset($data['id'])) { echo "ID: " . $data['id'] . "n"; } // ... 在此处处理您的业务逻辑 ... // 返回成功响应 header('Content-Type: application/json'); echo json_encode(['status' => '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请求。