萬盛學電腦網

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

PHP Stream 流包裝器深度解析:從 php://input 到自定義協議

什麼是 Stream?

PHP 4.3 引入 Stream 抽象層,統一「檔案、Socket、壓縮資料、記憶體」等資源的讀寫介面。一個 Stream = scheme://target,由包裝器實作特定協議。

內建包裝器查詢

<?php
var_dump(stream_get_transports());  // tcp, udp, unix, ssl, tls...
var_dump(stream_get_wrappers());    // https, ftps, compress.zlib, php, file, http, ftp, phar, zip...
var_dump(stream_get_filters());     // zlib.*, bzip2.*, convert.iconv.*, string.rot13...
?>

預設包裝器:file://

readfile('/path/to/file') 等同 readfile('file:///path/to/file')。

重點:php:// 包裝器家族

包裝器說明
php://stdin標準輸入(唯讀)
php://stdout標準輸出(唯寫)
php://stderr標準錯誤(唯寫)
php://input唯讀,取得原始 POST Body(非 multipart/form-data)
php://output唯寫,輸出到輸出緩衝區
php://memory記憶體暫存檔
php://temp臨時檔(超過記憶體限制自動落盤)

php://input 關鍵知識點

  1. 讀取未處理的 POST 原始資料,記憶體壓力比 $HTTP_RAW_POST_DATA 小,無需 php.ini 設定
  2. 不適用 enctype=multipart/form-data(檔案上傳)
  3. 僅當 Content-Type: application/x-www-form-urlencoded 且 POST 時,$_POST 內容與 php://input 內容「語義一致」(格式不同)
  4. 無法讀取 GET 資料(在 URL Query String,非 Body)

實際應用:XML-RPC / REST API 伺服端接收原始 JSON

$raw = file_get_contents('php://input');
$data = json_decode($raw, true);

Stream Context(流上下文)

以關聯陣列定義協議選項(HTTP 標頭、SSL 驗證、Proxy、Timeout 等),傳給 stream_context_create(),再以第四參數傳給 fopen()/file_get_contents() 等函式。詳細用法建議查閱官方文件。

自定義包裝器

實作 stream_wrapper_register() 註冊自定義協議(如 myproto://),需實作 stream_open/stream_read/stream_write/stream_stat 等介面方法。

安全提醒

駭客常利用 php://input 繞過 $_POST 檢查、或用 php://filter 讀取原始碼。請嚴格驗證輸入、禁用不必要的包裝器。

總結

Stream 是 PHP 底層 I/O 的統一抽象。掌握 php://input、php://memory、compress.zlib:// 等常用包裝器,能讓程式碼更簡潔、效能更高。

copyright © 萬盛學電腦網 all rights reserved