| 方式 | 适用 Content-Type | 获取方式 | 内存占用 | PHP 版本 | 典型场景 |
$_POST | application/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、老旧客户端 |
详细解析
1. $_POST —— 标准表单首选
<?php
// 前端:
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