php://input 是 PHP 提供的唯讀資料流,可直接讀取 HTTP 請求主體(Raw Body),適用於 Content-Type: application/json、application/x-www-form-urlencoded 等非 multipart/form-data 的 POST 請求。本文詳細說明使用時機、讀取方式、與 $HTTP_RAW_POST_DATA 差異,並以「攝像頭拍照上傳」為實戰案例。
| 條件 | 說明 |
|---|---|
| 請求方法 | 必須為 POST |
| Content-Type | 不能為 multipart/form-data(檔案上傳預設編碼) |
| PHP 設定 | 無需啟用 always_populate_raw_post_data(已於 PHP 7.0 移除) |
| 可讀次數 | 僅能讀取一次,讀取後指標到達 EOF |
<?php
// 客戶端表單:application/x-www-form-urlencoded
// POST body: name=tom&age=22
$raw = file_get_contents('php://input');
echo $raw; // 輸出:name=tom&age=22
// 解析為陣列
parse_str($raw, $data);
print_r($data); // ['name'=>'tom', 'age'=>'22']
前端 Canvas toBlob 或 toDataURL 產生二進位/Base64,以 application/octet-stream 或 application/json 送出:
canvas.toBlob(blob => {
fetch('/upload.php', {
method: 'POST',
headers: {'Content-Type': 'application/octet-stream'},
body: blob
});
}, 'image/png');
<?php
// 僅允許 POST
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
http_response_code(405);
exit('Method Not Allowed');
}
// 讀取原始二進位資料流
$imageData = file_get_contents('php://input');
if (!$imageData) {
http_response_code(400);
exit('Empty body');
}
// 簡易驗證 PNG 魔數
if (substr($imageData, 0, 8) !== "\x89PNG\r\n\x1a\n") {
http_response_code(400);
exit('Invalid PNG');
}
// 儲存
$filename = 'uploads/' . bin2hex(random_bytes(8)) . '.png';
file_put_contents($filename, $imageData);
echo json_encode(['status' => 'ok', 'file' => $filename]);
php.ini 設定 always_populate_raw_post_data = On 才會自動填入此超全域變數。php://input。php://input 為串流介面,記憶體效率更佳(可搭配 fopen('php://input', 'r') 分塊讀取超大資料)。<?php
$fp = fopen('php://input', 'r');
$dest = fopen('uploads/large_file.dat', 'wb');
while (!feof($fp)) {
fwrite($dest, fread($fp, 8192));
}
fclose($fp);
fclose($dest);
$_POST 只有在 application/x-www-form-urlencoded 或 multipart/form-data 才會自動填入;application/json 需自行 json_decode(file_get_contents('php://input'), true)。FormData 將 JSON 字串作為一個欄位送出,後端以 $_POST['json_field'] 接收。