php://input 是 PHP 中的一个核心伪协议（Wrapper），专门用于读取 HTTP 请求体中的原始数据，是处理非表单编码请求、接收原始数据流的关键工具。本文将从基础概念、使用场景、语法示例、注意事项等维度，全面解析 php://input 的使用方法。
一、php://input 核心概念
1. 定义与作用
php://input 是一个只读的数据流，用于获取 POST/PUT/PATCH 等请求方式中请求体的原始数据 ，不受php.ini中post_max_size以外的表单解析配置影响（如upload_max_filesize、enable_post_data_reading）。
2. 与 $_POST 的核心区别
| 特性 | php://input | $_POST |
|---|---|---|
| 数据格式支持 | 任意格式（JSON/XML/ 二进制 / 纯文本） | 仅支持application/x-www-form-urlencoded或multipart/form-data |
| 数据读取方式 | 流式读取，可按需读取部分内容 | 一次性解析为关联数组，占用内存 |
| 文件上传支持 | 不解析文件，仅读取原始字节流 | 自动解析multipart/form-data中的文件到$_FILES |
| 内存占用 | 低（流式读取） | 高（全部加载到内存） |
3. 适用场景
- 接收 JSON/XML 格式的 API 请求（如前后端分离项目）；
- 处理 PUT/PATCH 请求的原始数据；
- 接收二进制数据流（如文件上传、图片流）；
- 读取超大请求体（避免 $_POST 一次性加载占用内存）；
- 兼容非标准表单编码的请求数据。
二、php://input 基础使用方法
1. 基本读取语法
通过file_get_contents()或fopen()+fread()读取 php://input 的内容，推荐使用file_get_contents()（简洁高效）：
php
运行
// 方式1：一次性读取全部请求体（推荐）
$rawData = file_get_contents('php://input');
// 方式2：流式读取（适合超大请求体）
$handle = fopen('php://input', 'r');
$rawData = '';
while (!feof($handle)) {
$rawData .= fread($handle, 1024); // 每次读取1KB
}
fclose($handle);2. 典型使用场景示例
场景 1：接收 JSON 格式的 POST 请求
前端发送 JSON 数据：
javascript
运行
// 前端JS示例（Axios）
axios.post('/api/test.php', {
name: 'PHP编程',
type: '技术文档',
content: 'php://input使用指南'
}, {
headers: {
'Content-Type': 'application/json'
}
});后端 PHP 读取并解析：
php
运行
<?php
// 设置响应头为JSON格式
header('Content-Type: application/json; charset=utf-8');
// 读取原始JSON数据
$rawJson = file_get_contents('php://input');
// 解析为PHP数组
$data = json_decode($rawJson, true);
// 校验解析结果
if (json_last_error() !== JSON_ERROR_NONE) {
echo json_encode(['code' => 400, 'msg' => 'JSON格式错误']);
exit;
}
// 处理数据
$name = $data['name'] ?? '';
$type = $data['type'] ?? '';
// 返回响应
echo json_encode([
'code' => 200,
'msg' => '接收成功',
'data' => $data
]);
?>场景 2：处理 PUT 请求（RESTful API 常用）
PUT 请求通常用于更新资源，php://input 是读取其请求体的唯一方式：
php
运行
<?php
// 判断请求方式为PUT
if ($_SERVER['REQUEST_METHOD'] !== 'PUT') {
http_response_code(405); // 方法不允许
exit;
}
// 读取PUT请求体
$putData = file_get_contents('php://input');
// 解析（示例：表单格式）
parse_str($putData, $putParams);
// 输出解析结果
var_dump($putParams);
?>场景 3：接收二进制数据流（如图片上传）
php
运行
<?php
// 禁止PHP自动解析请求体
ini_set('enable_post_data_reading', 0);
// 读取二进制数据
$binaryData = file_get_contents('php://input');
// 校验数据是否为空
if (empty($binaryData)) {
http_response_code(400);
echo '无二进制数据';
exit;
}
// 保存为图片文件
$savePath = './upload_' . uniqid() . '.jpg';
file_put_contents($savePath, $binaryData);
echo '文件保存成功：' . $savePath;
?>三、关键注意事项
1. 仅适用于有请求体的请求
php://input 仅在 POST/PUT/PATCH 等包含请求体的请求中有效，GET 请求无请求体，读取结果为空。
2. enable_post_data_reading配置影响
若php.ini中enable_post_data_reading = 0，PHP 不会自动解析 POST 数据，此时 $_POST 为空，但仍可通过 php://input 读取原始数据。
3. multipart/form-data格式的特殊处理
当请求头Content-Type为multipart/form-data（表单文件上传）时：
- php://input 仍可读取原始数据，但数据包含分隔符、文件头、二进制内容等，解析复杂；
- 推荐使用
$_FILES处理文件上传，而非手动解析 php://input。
4. 数据只能读取一次
php://input 是流式资源，读取一次后指针到达末尾，再次读取会返回空。若需多次使用，需先保存到变量：
php
运行
// 错误示例：多次读取
file_get_contents('php://input'); // 第一次读取（有数据）
file_get_contents('php://input'); // 第二次读取（空）
// 正确示例：保存到变量后复用
$inputData = file_get_contents('php://input');
// 后续使用$inputData即可5. 内存限制
读取超大请求体时，需注意memory_limit配置，避免内存溢出。建议使用流式读取（fopen+fread）而非一次性读取：
php
运行
// 流式读取超大请求体
$handle = fopen('php://input', 'r');
$file = fopen('./large_data.txt', 'w');
while (!feof($handle)) {
$chunk = fread($handle, 4096); // 每次读取4KB
fwrite($file, $chunk);
}
fclose($handle);
fclose($file);6. post_max_size限制
请求体大小受php.ini中post_max_size限制（默认 8M），若超过该值，php://input 读取结果为空，需调整配置：
ini
; php.ini配置
post_max_size = 64M ; 调整为64M四、常见问题排查
1. 读取 php://input 返回空
- 确认请求方式为 POST/PUT 等（非 GET）；
- 检查请求头
Content-Length是否大于 0； - 确认未提前读取过 php://input；
- 检查
post_max_size是否小于请求体大小； - 若使用框架（如 Laravel），确认框架未提前读取 php://input（可通过
$request->getContent()获取）。
2. JSON 解析失败
- 检查前端发送的 JSON 格式是否合法（可通过https://jsonlint.com/校验）；
- 确认请求头
Content-Type: application/json已正确设置； - 检查数据编码（确保 UTF-8，无特殊字符）。
五、总结
php://input 是 PHP 处理原始 HTTP 请求体的核心工具，相比 $_POST 更灵活，支持任意数据格式，是开发 API、处理非标准请求的必备技能。使用时需注意：
- 按需选择读取方式（一次性 / 流式）；
- 避免重复读取；
- 结合请求头类型选择解析方式；
- 关注内存和请求体大小限制。
合理使用 php://input，可高效处理各类自定义格式的 HTTP 请求，适配前后端分离、RESTful API 等现代开发场景。