要获取POST请求的原始报文，应使用php://input流配合file_get_contents函数读取，它能获取未经解析的原始数据，适用于JSON、XML等非标准格式；而$_POST仅解析application/x-www-form-urlencoded和multipart/form-data类型的数据，无法处理其他格式。
在PHP中，要获取POST请求的原始报文，最直接且推荐的方法是使用
php://input
流。这个特殊的I/O流允许你读取请求体中的原始数据，而无需PHP对其进行任何解析。这对于处理非标准格式（如JSON、XML或自定义二进制数据）的POST请求尤其有用。
解决方案
要获取原始POST数据，你只需要读取
php://input
流的内容即可。这通常通过
file_get_contents()
函数来完成。
'success', 'received_data' => $rawData]); // 实际应用中，你可能需要根据Content-Type来解析它 $contentType = $_SERVER['CONTENT_TYPE'] ?? ''; if (strpos($contentType, 'application/json') !== false) { $data = json_decode($rawData, true); if (json_last_error() === JSON_ERROR_NONE) { // 成功解析JSON error_log("Received JSON data: " . print_r($data, true)); // ... 处理数据 ... } else { error_log("JSON decoding error: " . json_last_error_msg()); // ... 错误处理 ... } } elseif (strpos($contentType, 'application/xml') !== false) { // 尝试解析XML libxml_use_internal_errors(true); // 抑制XML错误，自行处理 $xml = simplexml_load_string($rawData); if ($xml !== false) { error_log("Received XML data: " . print_r($xml, true)); // ... 处理XML数据 ... } else { error_log("XML parsing error: " . implode(', ', array_map(fn($e) => $e->message, libxml_get_errors()))); libxml_clear_errors(); // ... 错误处理 ... } } else { // 处理其他类型或纯文本 error_log("Received raw data (Content-Type: {$contentType}): " . $rawData); // ... 处理其他数据 ... }} else { // 不是POST请求，可能需要返回错误或提示 header('HTTP/1.1 405 Method Not Allowed'); echo "This endpoint only accepts POST requests.";}?>
php://input
php://input
和
$_POST
有什么本质区别？
说实话，这真的是一个我们开发者经常会混淆，或者说需要深入理解的关键点。简单来讲，
$_POST
是PHP为了方便处理特定类型的POST请求而提供的“糖衣”，而
php://input
则是更底层的原始数据通道。
$_POST
这个超全局变量，它并非总能获取到所有POST数据。它的主要工作是解析那些
Content-Type
为
application/x-www-form-urlencoded
或
multipart/form-data
的POST请求体。当请求头是这两种类型时，PHP会自动解析请求体，并把键值对填充到
$_POST
数组中。这非常方便，就像我们平时提交表单一样。
立即学习“PHP免费学习笔记（深入）”；
然而，一旦POST请求的
Content-Type
不是上述两种，比如是
application/json
、
application/xml
，甚至是自定义的二进制流，
$_POST
就会“失灵”了。在这种情况下，
$_POST
数组会是空的，因为它不知道如何解析这些非标准格式。这时候，
php://input
就派上用场了。它提供的是请求体未经PHP解析的原始字节流。你可以把它想象成一个只读文件，里面原封不动地存放着客户端发送过来的所有数据。
所以，核心区别在于：
$_POST
是PHP“帮你处理过”的数据，而
php://input
则是“原始的、未经处理的”数据。我个人觉得，当你需要处理API接口（特别是RESTful API，它们通常用JSON或XML交换数据）或者一些自定义协议时，
php://input
几乎是你的不二选择。
处理不同Content-Type的POST请求时，
php://input
php://input
的最佳实践是什么？
在我看来，处理不同
Content-Type
的POST请求，关键在于“识别”和“适配”。既然
php://input
给了我们原始数据，那我们就要根据请求的
Content-Type
来决定如何“解读”这份数据。
最常见的实践流程是：
获取原始数据： 毫无疑问，先用
file_get_contents('php://input')
把原始请求体抓下来。这是所有后续操作的基础。检查
Content-Type
头： 这是决定解析策略的关键。通过
$_SERVER['CONTENT_TYPE']
可以获取到这个信息。注意，这个值可能包含编码信息（如
application/json; charset=UTF-8
），所以通常需要用
strpos
或
explode
来判断主类型。根据类型进行解析：
application/json
： 这是现代API最常用的格式。拿到原始数据后，直接用
json_decode($rawData, true)
解析成PHP数组或对象。记住，
json_decode
的第二个参数设为
true
可以让你得到关联数组，这在PHP中通常更方便操作。解析后，务必检查
json_last_error()
和
json_last_error_msg()
来处理潜在的JSON格式错误。
application/xml
： 如果是XML数据，
simplexml_load_string($rawData)
是个不错的选择，它能将XML转换成
SimpleXMLElement
对象，方便我们以对象属性的方式访问数据。同样，错误处理（例如
libxml_use_internal_errors(true)
和
libxml_get_errors()
）是不可或缺的。
text/plain
或其他自定义类型： 这类数据可能就是纯文本，或者需要你自己定义解析规则。直接使用
$rawData
即可，如果需要，可以配合正则表达式或其他字符串处理函数进行提取。
application/x-www-form-urlencoded
和
multipart/form-data
： 虽然
$_POST
已经处理了它们，但如果你出于某种特殊原因（比如想自己完全控制解析过程，或者想获取原始的编码字符串）也想通过
php://input
获取，那也可以。不过，对于
application/x-www-form-urlencoded
，你需要自己用
parse_str()
函数来解析；对于
multipart/form-data
，这会变得非常复杂，因为它涉及到边界符和多部分数据的解析，通常不推荐自己手动处理，还是让
$_POST
和
$_FILES
去处理吧。
一个重要的提示是，无论你解析什么类型的数据，都应该对结果进行严格的验证和过滤。不要盲目相信客户端发送过来的数据，安全永远是第一位的。
在特定场景下，获取原始POST数据可能遇到的挑战及解决方案？
在使用
php://input
获取原始POST数据时，确实会遇到一些小麻烦，这不像
$_POST
那么“傻瓜式”。我个人在实际项目中就踩过几个坑，分享一下常见的挑战和对应的解决方案：
php://input
只能读取一次： 这是最常见的一个限制。一旦你用
file_get_contents('php://input')
读取了数据，这个流就到达了末尾。如果你尝试再次读取，你会得到一个空字符串。
解决方案： 最简单有效的方法是，第一次读取后，将数据存储到一个变量中。后续所有对原始数据的操作都应该使用这个变量。
$rawData = file_get_contents('php://input');// 后续操作都用 $rawData$decodedData = json_decode($rawData, true);// ...
如果你在框架中使用，通常框架会在请求生命周期早期就将
php://input
的内容读取并缓存起来，避免这个问题。
大文件上传的误区： 有些开发者可能会错误地认为
php://input
也能用来处理大文件上传，尤其是
multipart/form-data
格式的文件。
解决方案： 明确一点，
php://input
不适合处理
multipart/form-data
类型的大文件上传。PHP的
$_FILES
超全局变量就是为此而生的。当请求是
multipart/form-data
时，PHP会将文件数据存储到临时目录，并将文件信息填充到
$_FILES
中。尝试用
php://input
手动解析
multipart/form-data
是一个非常复杂且低效的任务，涉及到解析复杂的边界符和编码，几乎是自找麻烦。所以，对于文件上传，老老实实地用
$_FILES
吧。
请求体为空的情况： 有时候客户端可能发送了一个POST请求，但请求体是空的。这时
file_get_contents('php://input')
就会返回一个空字符串。
解决方案： 在处理
$rawData
之前，先检查它是否为空。根据你的业务逻辑，空请求体可能意味着错误，也可能是一种合法的空操作。
$rawData = file_get_contents('php://input');if (empty($rawData)) { // 处理空请求体的情况，例如返回错误或执行默认操作 error_log("Received an empty POST request body."); // header('HTTP/1.1 400 Bad Request'); // echo json_encode(['error' => 'Request body cannot be empty.']); exit();}// ... 继续处理非空数据 ...
内存消耗问题： 如果客户端发送的POST请求体非常巨大（比如几十MB的JSON或XML），
file_get_contents('php://input')
会一次性将所有数据加载到内存中。这可能会导致PHP脚本的内存溢出。
解决方案： 对于绝大多数HTTP请求，请求体的大小都在可控范围内，
file_get_contents
是没问题的。但如果你的应用确实需要处理超大请求体，并且不能通过
$_FILES
解决，你可能需要考虑更底层的流式处理，例如使用
fopen('php://input', 'r')
获取文件句柄，然后使用
fread()
或
stream_get_contents()
配合缓冲区分块读取。不过，这种场景相对较少，而且通常意味着你的系统架构可能需要更专业的流处理或消息队列来应对。在实践中，我会优先考虑在Web服务器层面（如Nginx）限制请求体大小，防止恶意或异常的大请求到达PHP应用。
总的来说，
php://input
是一个非常强大的工具，但使用时需要对其特性和潜在问题有所了解。理解它和
$_POST
的差异，并根据
Content-Type
采取合适的解析策略，就能让你在处理各种POST请求时游刃有余。
以上就是PHP如何获取POST数据的原始报文_PHP获取原始POST请求数据的方法的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1294271.html
微信扫一扫 
支付宝扫一扫 
