PHP 中 $_POST 与 php://input 的区别及使用场景

问题现象：为什么 $_POST 为空？

在测试 HTTP 请求时，常遇到前端成功发送数据但后端 $_POST 数组为空的情况。例如，使用 Node.js http 模块发起一个简单的 POST 请求：

var options = {
    host: 'localhost',
    port: 80,
    path: '/backbone/data.php',
    method: 'POST'
};

var req = http.request(options, function(res) {
    console.log('STATUS: ' + res.statusCode);
    console.log('HEADERS: ' + JSON.stringify(res.headers));
    res.setEncoding('utf8');
    res.on('data', function (chunk) {
        console.log('BODY: ' + chunk);
    });
});

// 写入请求体数据
req.end('name=liuzhang&age=28');

若此时 PHP 端使用以下代码：

输出的结果往往是空数组。这是因为默认的 Node.js 请求并没有显式设置 Content-Type 头部，或者其默认行为未匹配 PHP 解析表单数据的严格条件。

解决方案：使用 php://input 接收原始数据

要解决这个问题，可以使用 PHP 内置的只读流 php://input。它允许读取 POST 的原始数据，不依赖于特定的 PHP 配置指令（如 always_populate_raw_post_data）。

将后端代码修改为：

即可成功接收到传递的字符串数据。相比已废弃的 $HTTP_RAW_POST_DATA，php://input 更加灵活且内存占用更低。

第1步：理解 $_POST 的工作机制

• 适用条件： $_POST 仅在请求体的 MIME 类型为 application/x-www-form-urlencoded 或 multipart/form-data 时才有效。
• 数据转换： 对于 x-www-form-urlencoded 类型，PHP 会自动将 key=value&key2=value2 格式的字符串解析为关联数组存入 $_POST。
• 限制： 如果是 JSON、XML 或其他自定义格式的请求体，$_POST 将无法解析这些数据。

第2步：明确 php://input 的使用规范

• 直接访问： 该流直接指向 HTTP 请求体（Request Body）。
• 只读特性： 只能读取一次，适合用于 API 接口对接、微服务通信等需要精准控制请求体内容的场景。
• 失效情况： 当 enctype="multipart/form-data"（通常用于文件上传）时，php://input 无效，此时应完全依赖 $_FILES 和 $_POST。

第3步：修正请求头以兼容 $_POST

如果业务逻辑必须使用 $_POST 来处理数据，则必须在发送请求时显式指定正确的 Content-Type 头部：

var options = {
    host: 'localhost',
    port: 80,
    path: '/backbone/data.php',
    method: 'POST',
    headers : {'Content-Type': 'application/x-www-form-urlencoded'}
};

加上此 Header 后，PHP 内核就能正确识别数据格式并将其反序列化为数组。

完成判断总结

• 验证接口连通性： 检查 HTTP 响应码是否为 200。
• 确认数据格式： 确保 Request Body 内容与 Content-Type 头部匹配。
• 获取最终结果： 根据需求选择解析 $_POST['key'] 还是使用 file_get_contents('php://input')。

简要排错指南

• 排查问题： 若 $_POST 始终为空，优先检查请求是否附带了有效的 Content-Type 头部；若发送的是非表单类数据（如 Raw JSON），务必切换到 php://input。
• 安全提醒： php://input 仅适用于 POST 请求。在使用 GET 请求参数时，应使用预定义的超全局变量 $_GET，切勿尝试从输入流读取 GET 参数。

以上就是对 PHP 输入输出流中 php://input 及 $_POST 处理机制的详细解析，更多关于 PHP 网络请求的资料请关注本站其它相关文章！