PHP 获取非表单格式的原始 POST 数据方法

当PHP接收来自第三方服务（如TradingView、Webhook平台或IoT设备）发送的无字段名原始POST数据（如纯文本、JSON或自定义格式）时，$_POST和$_REQUEST始终为空——这不是Bug，而是PHP的设计机制；本文直击这一高频痛点，详解为何必须使用file_get_contents('php://input')来可靠读取原始请求体，并附上兼容性强、开箱即用的实战代码，助你轻松应对各类非标准HTTP POST场景。

当客户端通过 curl 发送无字段名的原始 POST 数据（如纯文本、JSON 或自定义格式）时，PHP 的 $_POST 和 $_REQUEST 为空；此时必须使用 file_get_contents('php://input') 手动读取原始请求体。

当客户端通过 curl 发送无字段名的原始 POST 数据（如纯文本、JSON 或自定义格式）时，PHP 的 `$_POST` 和 `$_REQUEST` 为空；此时必须使用 `file_get_contents('php://input')` 手动读取原始请求体。

在 Web 开发中，常遇到第三方服务（如 TradingView、Webhook 平台或 IoT 设备）以非标准方式发起 HTTP POST 请求：它们不使用 application/x-www-form-urlencoded 或 multipart/form-data 编码，而是直接发送裸数据（raw body），例如：

curl -H 'Content-Type: text/plain; charset=utf-8' \
     -d '1111111111,data,more-data' \
     -X POST https://your-domain.com/webhook.php

这类请求没有键值对结构（即无 name=value 字段），因此 PHP 不会自动解析并填充 $_POST 或 $_REQUEST —— 这是 PHP 的设计行为，而非 Bug。$_POST 仅在 Content-Type 为 application/x-www-form-urlencoded 或 multipart/form-data 且数据符合对应格式时才被填充。

✅ 正确解决方案：使用 php://input 流
php://input 是一个只读流，允许你一次性读取原始的、未修改的 HTTP 请求体内容（适用于 POST、PUT、PATCH 等方法），且不受 Content-Type 限制（只要不是 multipart/form-data，该类型下 php://input 会被禁用）。

以下是改进后的完整处理示例（兼容原脚本逻辑）：

<?php
// 设置时区
date_default_timezone_set('America/Phoenix');

// 构建日志前缀
$log = date('Y/m/d h:i:sa') . "\n";
$url = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? 'https' : 'http')
       . "://{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}";
$log .= "URL: $url\n\n";

// ✅ 关键：读取原始 POST 数据（适用于 raw body）
$rawInput = file_get_contents('php://input');
if ($rawInput !== '') {
    $log .= "RAW INPUT:\n" . $rawInput . "\n\n";
}

// 同时保留 $_REQUEST（用于传统表单提交）
if (!empty($_REQUEST)) {
    $log .= "\$_REQUEST:\n" . var_export($_REQUEST, true) . "\n\n";
}

// 获取并记录请求头
$headers = apache_request_headers();
if (!empty($headers)) {
    $log .= "HEADERS:\n" . var_export($headers, true) . "\n\n";
}

$log .= str_repeat('-', 40) . "\n";
file_put_contents('./webhook.log', $log, FILE_APPEND);

// 可选：返回响应（便于调试）
header('Content-Type: text/plain; charset=utf-8');
echo "OK: Received " . strlen($rawInput) . " bytes of raw data.\n";
?>

⚠️ 注意事项：

• php://input 只能读取一次（类似文件指针），重复调用将返回空字符串；
• 若请求使用 enctype="multipart/form-data"（含文件上传），php://input 不可用，应改用 $_FILES + $_POST 组合；
• 确保 enable_post_data_reading = On（默认开启）且未启用 suhosin 等安全扩展强制拦截；
• 对于 JSON 数据，可进一步解析：$data = json_decode($rawInput, true);，但需先校验 json_last_error() === JSON_ERROR_NONE；
• 生产环境建议添加 Content-Length 校验与超时防护，避免恶意大体积 payload。

总结：面对非表单类 POST 请求（如 Webhook、API 集成），放弃依赖 $_POST，转而主动读取 php://input —— 这是 PHP 处理原始请求体的标准、可靠且轻量的方式。

到这里，我们也就讲完了《PHP 获取非表单格式的原始 POST 数据方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！