萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 接收 POST 数据的三种方式:$_POST、php://input、$GLOBALS['HTTP_RAW_POST_DATA'] 深度对比

三种方式对比表

详细解析

1. $_POST —— 标准表单首选

<?php
// 前端: 
// 或 AJAX: contentType: 'application/x-www-form-urlencoded' $name = $_POST['name'] ?? ''; $email = $_POST['email'] ?? ''; // 文件上传另用 $_FILES // $_POST 不包含文件数据

2. php://input —— 现代 API 标准

<?php
// 前端: fetch('/api', {method:'POST', body: JSON.stringify({a:1}), headers:{'Content-Type':'application/json'}})

$raw = file_get_contents('php://input'); // 读取原始请求体
$data = json_decode($raw, true);         // 解析 JSON

// 优势:
// - 不依赖 Content-Type 解析器
// - 可读取任意格式 (JSON, XML, Protobuf, 纯文本)
// - 流式读取,大请求体不撑爆内存
// - 无需 php.ini 配置

3. $HTTP_RAW_POST_DATA —— 遗留兼容

<?php
// PHP 5.6 需在 php.ini: always_populate_raw_post_data = -1
// PHP 7.0+ 已移除,不可用

// 仅用于无法修改的古老 SOAP/XML-RPC 客户端
$raw = $GLOBALS['HTTP_RAW_POST_DATA'] ?? file_get_contents('php://input');

实战演示:三种方式同时接收对比

<?php
// post.php
header('Content-Type: text/html; charset=utf-8');

echo '<h3>$_POST</h3><pre>'; print_r($_POST); echo '</pre>';
echo '<h3>$GLOBALS[HTTP_RAW_POST_DATA]</h3><pre>'; print_r($GLOBALS['HTTP_RAW_POST_DATA'] ?? 'N/A (PHP 7+)'); echo '</pre>';
echo '<h3>php://input</h3><pre>'; print_r(urldecode(file_get_contents('php://input'))); echo '</pre>';

测试表单 a.html

<form action="post.php" method="post">
    Name: <input name="name"><br>
    Address: <input name="address"><br>
    <button type="submit">Submit</button>
</form>

进阶:统一封装获取请求体

<?php
function getRequestPayload(): array|string {
    $contentType = $_SERVER['CONTENT_TYPE'] ?? '';

    // JSON API
    if (str_contains($contentType, 'application/json')) {
        return json_decode(file_get_contents('php://input'), true) ?? [];
    }

    // XML
    if (str_contains($contentType, 'xml')) {
        return simplexml_load_string(file_get_contents('php://input'));
    }

    // 表单
    if (str_contains($contentType, 'application/x-www-form-urlencoded') ||
        str_contains($contentType, 'multipart/form-data')) {
        return $_POST;
    }

    // 其他: 返回原始字符串
    return file_get_contents('php://input');
}

文件上传特殊说明

  • multipart/form-data 仅能通过 $_POST + $_FILES 获取
  • php://input 无法 读取 multipart 请求体 (PHP 内部已消费)
  • 大文件上传进度监控需用 session.upload_progress 或 Nginx 上传模块

最佳实践决策树

IF Content-Type 是 application/json 或 text/xml 或 application/octet-stream
    → 用 file_get_contents('php://input')
ELSE IF Content-Type 是 application/x-www-form-urlencoded
    → 用 $_POST (已自动解析)
ELSE IF Content-Type 是 multipart/form-data
    → 用 $_POST + $_FILES
ELSE
    → 尝试 php://input 兜底

常见坑

🔴 php://input 只能读取一次 (流不可重读),需存变量复用
🔴 $_POST 会自动 urldecode,php://input 返回原始需手动 urldecode()
🔴 旧代码用 $HTTP_RAW_POST_DATA 迁移到 php://input
🔴 enctype="text/plain" 表单仅 php://input 可读

现代 PHP 开发:表单用 $_POST,API 用 php://input,遗留兼容用兼容层。

copyright © 萬盛學電腦網 all rights reserved
方式适用 Content-Type获取方式内存占用PHP 版本典型场景
$_POSTapplication/x-www-form-urlencoded
multipart/form-data
超全局数组自动填充低 (已解析)所有版本普通表单、AJAX form 提交
php://input任意 (除 multipart/form-data)file_get_contents('php://input')低 (流式)PHP 5.6+JSON API、XML、原始二进制、Webhook
$GLOBALS['HTTP_RAW_POST_DATA']非标准 MIME 类型自动填充 (需 always_populate_raw_post_data=-1)高 (全量缓存)PHP 5.6 弃用,7.0 移除遗留 SOAP、老旧客户端