萬盛學電腦網

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

PHP php://input 讀取原始 POST 資料流完整指南(含檔案上傳實戰)

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']

實戰:攝像頭拍照上傳(Base64/Blob 直傳)

前端 Canvas toBlob 或 toDataURL 產生二進位/Base64,以 application/octet-stream 或 application/json 送出:

前端(JavaScript)

canvas.toBlob(blob => {
    fetch('/upload.php', {
        method: 'POST',
        headers: {'Content-Type': 'application/octet-stream'},
        body: blob
    });
}, 'image/png');

後端(upload.php)

<?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]);

對比:$HTTP_RAW_POST_DATA(已棄用)

  • PHP 5.6 前需在 php.ini 設定 always_populate_raw_post_data = On 才會自動填入此超全域變數。
  • PHP 7.0 正式移除,請一律改用 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)。
  • 若同時需處理檔案上傳(multipart)與 JSON 欄位,建議前端改用 FormData 將 JSON 字串作為一個欄位送出,後端以 $_POST['json_field'] 接收。
copyright © 萬盛學電腦網 all rights reserved