本文旨在解决php应用在接收application/json类型的post请求时，$_post超全局变量为空的问题。我们将深入解释$_post的工作机制，并提供一种标准且可靠的方法，通过读取php://input流来获取原始json数据，并进行解析，确保php后端能正确处理json格式的api请求。
理解$_POST与内容类型
在PHP中，$_POST是一个超全局数组，用于收集通过HTTP POST方法提交的表单数据。然而，$_POST并非设计用于处理所有类型的POST请求体。它主要针对以下两种内容类型（Content-Type）：
- application/x-www-form-urlencoded: 这是HTML表单默认的编码方式。数据以键值对的形式进行URL编码，并作为请求体发送。例如：id=12345&name=test。
- multipart/form-data: 当表单包含文件上传时使用。数据被分割成多个部分，每部分都有自己的头部，例如Content-Disposition。
当客户端发送Content-Type: application/json的请求时，请求体是一个纯粹的JSON字符串，PHP的SAPI（Server API）不会自动解析这个JSON字符串并填充到$_POST数组中。因此，在这种情况下，$_POST将保持为空。
获取原始JSON请求体
要获取application/json类型的POST请求体，我们需要直接读取PHP的输入流。PHP提供了一个特殊的包装器php://input，它允许我们访问原始的请求体数据。
php://input是一个只读流，它允许你读取原始的POST数据。与$_POST不同，php://input不依赖于特定的Content-Type，它会提供请求体中所有原始数据。
立即学习“PHP免费学习笔记（深入）”；
读取和解析JSON数据
以下是使用file_get_contents('php://input')读取原始JSON数据，并使用json_decode()将其转换为PHP数组或对象的标准方法：
<?php
// 确保只处理POST请求
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
// 获取原始的JSON请求体
$jsonString = file_get_contents('php://input');
// 检查是否成功获取数据
if ($jsonString === false || $jsonString === '') {
http_response_code(400); // Bad Request
echo json_encode(['error' => 'No data or invalid data provided.']);
exit;
}
// 将JSON字符串解码为PHP数组
// 第二个参数为 true 时，返回关联数组；为 false 时，返回对象
$data = json_decode($jsonString, true);
// 检查JSON解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400); // Bad Request
echo json_encode(['error' => 'Invalid JSON format.', 'json_error' => json_last_error_msg()]);
exit;
}
// 打印解析后的数据以供调试
print_r($data);
// 示例：访问数据
if (isset($data['id'])) {
echo "Received ID: " . $data['id'] . "\n";
} else {
echo "ID not found in JSON data.\n";
}
// 在实际应用中，你可能会将数据存储到数据库，或进行其他业务逻辑处理
// ...
http_response_code(200); // OK
echo json_encode(['message' => 'Data received successfully!', 'data' => $data]);
} else {
http_response_code(405); // Method Not Allowed
echo json_encode(['error' => 'Only POST requests are allowed.']);
}
?>发送JSON请求的客户端示例
为了测试上述PHP代码，你可以使用curl命令行工具来发送一个application/json类型的POST请求。
curl -X POST 'localhost/api/v1/customers' \
-H 'Content-Type: application/json' \
-d '{"id":"12345", "name": "John Doe"}'这里：
- -X POST 指定请求方法为POST。
- 'localhost/api/v1/customers' 是你的PHP脚本的URL。
- -H 'Content-Type: application/json' 设置请求头，明确告诉服务器发送的是JSON数据。
- -d '{"id":"12345", "name": "John Doe"}' 或 --data 指定要发送的原始请求体数据。
完整示例与输出
当你运行上述curl命令，并请求包含前面PHP代码的脚本时，你将在终端看到类似如下的输出：
PHP脚本输出（print_r($data)部分）：
Array
(
[id] => 12345
[name] => John Doe
)
Received ID: 12345HTTP响应体（echo json_encode(...)部分）：
{"message":"Data received successfully!","data":{"id":"12345","name":"John Doe"}}这表明PHP脚本已经成功接收并解析了JSON数据。
注意事项与最佳实践
- 错误处理: 始终检查json_decode()的返回值。如果JSON字符串格式不正确，json_decode()会返回null。可以使用json_last_error()和json_last_error_msg()函数获取详细的错误信息。
-
内容类型检查: 在处理php://input之前，最好检查请求的Content-Type头。这样可以确保你的脚本只尝试解析JSON数据，而不是其他类型的数据。
$contentType = trim(explode(';', $_SERVER['CONTENT_TYPE'])[0]); if ($contentType !== 'application/json') { http_response_code(415); // Unsupported Media Type echo json_encode(['error' => 'Content-Type must be application/json']); exit; } - 安全性: 从客户端接收到的任何数据都应被视为不可信。在将解析后的数据用于数据库查询、文件操作或显示给用户之前，务必进行严格的验证、过滤和转义，以防止SQL注入、XSS攻击等安全漏洞。
- 性能: 对于非常大的请求体，file_get_contents('php://input')会一次性将整个请求体读入内存。如果内存是一个问题，可以考虑使用流式读取，但这对于大多数Web API请求来说通常不是必需的。
- 框架集成: 如果你正在使用PHP框架（如Laravel, Symfony, Yii等），它们通常会提供更高级的抽象来处理JSON请求，你可能不需要直接使用file_get_contents('php://input')。框架的请求对象通常会有一个方法（例如$request->json()或$request->getContent()）来方便地获取和解析JSON数据。
总结
理解$_POST超全局变量的局限性以及php://input流的用途，是正确处理application/json类型POST请求的关键。通过结合file_get_contents('php://input')和json_decode()，PHP开发者可以构建健壮且符合RESTful API规范的后端服务，有效接收和处理JSON格式的数据。同时，遵循错误处理和安全最佳实践，将确保应用的稳定性和安全性。
