php 如何获取 post 传递的raw 数据

封面图 • 2025-05-22 • PHP

在 PHP 中，如果你需要获取通过 `POST` 请求传递的原始数据（即未解析为表单字段或 JSON 的原始请求体），可以使用 `php://input` 流来读取。

以下是具体的实现方式：

---

### 方法：使用 `php://input`
`php://input` 是一个只读流，允许你访问原始请求的数据。它适用于以下场景：
1. 请求头中没有指定 `Content-Type` 或是 `application/octet-stream`。
2. 数据不是标准的 `application/x-www-form-urlencoded` 或 `multipart/form-data` 格式。
3. 数据可能是 JSON、XML 或其他格式。

#### 示例代码
```php
<?php
// 获取 POST 请求的原始数据
$rawData = file_get_contents('php://input');

// 输出原始数据
echo "Raw Data: ";
var_dump($rawData);

// 如果数据是 JSON 格式，可以尝试解码
if ($rawData !== false && json_decode($rawData) !== null) {
    $decodedData = json_decode($rawData, true);
    echo "Decoded JSON Data: ";
    var_dump($decodedData);
} else {
    echo "Data is not valid JSON.";
}
?>
```

---

### 注意事项
1. **安全性**：如果数据是 JSON 格式，请确保对解码后的数据进行验证和清理，避免潜在的安全风险（如注入攻击）。
2. **限制性**：`php://input` 不会触发 `$_POST` 变量的填充，因此不能直接通过 `$_POST` 访问原始数据。
3. **性能**：对于大体量的数据，直接读取 `php://input` 比解析为 `$_POST` 更高效。

---

### 示例应用场景
假设客户端发送了一个 JSON 格式的 POST 请求，内容如下：
```json
{
    "name": "John Doe",
    "age": 30
}
```

服务器端接收并处理该数据：
```php
<?php
$data = file_get_contents('php://input');
$decodedData = json_decode($data, true);

if (json_last_error() === JSON_ERROR_NONE) {
    echo "Name: " . htmlspecialchars($decodedData['name']);
    echo "Age: " . htmlspecialchars($decodedData['age']);
} else {
    echo "Error decoding JSON: " . json_last_error_msg();
}
?>
```

输出结果：
```
Name: John Doe
Age: 30
```

---

### 总结
通过 `php://input`，你可以轻松获取 `POST` 请求的原始数据，并根据实际需求进行解析和处理。这种方式特别适合处理非标准的 `POST` 数据格式（如 JSON）。