PHP中php://input的用法：获取原始POST数据与上传二进制流

半杯拿铁

发布时间：2026-10-14 | 3人浏览过

原创

在PHP开发中，处理非标准表单提交的原始数据流是常见需求。php://input是一个只读流，允许在特定POST请求下直接读取请求主体内容。本文将介绍其基本用法、适用条件以及与旧变量的对比，帮助用户高效处理JSON或二进制数据传输。

php://input的基本功能与条件

php://input 是一个指向请求原始正文的只读流。它并非官方推荐的标准特性，但在实际开发中被广泛使用，特别是在需要绕过$POST自动解析的场景。
使用php://input必须满足以下两个核心条件：

请求方法必须是POST：GET或其他方法无法通过此流读取数据。
Content-Type不能为multipart/form-data：如果请求包含了文件上传（即enctype为multipart/form-data），则无法使用php://input，此时应查阅$FILES超全局变量。

基础操作：获取普通POST参数

当客户端发送标准的URL-encoded表单数据时，服务端可以通过file_get_contents()函数结合php://input来捕获原始字符串。

第1步：构建客户端提交

客户端创建一个简单的HTML表单，提交包含文本字段的POST请求。虽然示例简单，但逻辑适用于任何非文件上传的POST数据。注意action属性在实际项目中应指向处理脚本路径。

<form action="handle.php" method="POST">
  name: <input type="text" name="name" value="tom" /><br />
  age: <input type="text" name="age" value="22" /><br />
  <input type="submit" value="Submit" />
</form>

第2步：服务端接收并解析

在服务端脚本中，使用file_get_contents()读取php://input。该函数将返回请求主体的原始字节串。

<?php
// 读取原始POST数据
$content = file_get_contents("php://input");

// 输出结果通常为 key=value&amp;key2=value2 格式
echo $content;
?>

执行后，浏览器将显示类似name=tom&age=22的字符串。开发者随后可根据需要使用parse_str()将其转换为数组，或直接按业务规则解析。

进阶应用：接收二进制流（如图片）

除了文本数据，php://input常用于接收前端（如摄像头、小程序或专用客户端）直接推送的二进制数据流。例如，客户端拍照后将图像流POST到服务器，服务端可直接保存。

操作步骤如下：

客户端发送流：将图像数据作为请求体发送，Content-Type通常设为image/jpeg或application/octet-stream。
服务端接收并写入文件：

<?php
$binaryData = file_get_contents("php://input");

// 定义保存路径和文件名
$filename = "upload_" . time() . ".jpg";
$filepath = "/path/to/upload/" . $filename;

// 将二进制流写入文件
if ($binaryData !== false) {
    file_put_contents($filepath, $binaryData);
    echo "图片保存成功：" . $filepath;
} else {
    echo "没有接收到有效的数据流";
}

这种方式避免了先将文件保存到临时目录再移动的繁琐过程，适合实时性要求高的场景。

替代方案对比：php://input vs $HTTP_RAW_POST_DATA

在PHP早期版本中，$HTTP_RAW_POST_DATA也用于获取原始POST数据。它与php://input的内容本质相同，但存在显著差异：

配置依赖：$HTTP_RAW_POST_DATA需要在php.ini中开启always_populate_raw_post_data = On，重启Web服务器后才生效。若未开启，该变量可能为空或未定义。
内存占用：$HTTP_RAW_POST_DATA会将所有原始数据加载到内存中，对于大体积请求可能导致内存溢出。php://input虽然是流式读取，但若使用file_get_contents一次性读取，同样会占用内存，建议对大文件使用流式处理方式。
兼容性：$HTTP_RAW_POST_DATA在PHP 5.6及以上版本中已被废弃，不再推荐使用。