Stream(流) 是 PHP 中最強大却常被忽視的功能之一。它源於 UNIX 管道概念,將「資料來源」與「處理邏輯」解耦:無論是檔案、網路連線、壓縮資料、加密通道,統統可用統一的 fopen/fread/fwrite/fclose 介面操作。PHP 內建支援 file://、https://、ftp://、php://、zlib://、data:// 等多種協議封裝器。
http、ftp、compress.zlib)stream_context_create() 建立的參數包,控制 HTTP header、SSL 驗證、超時、代理等string.rot13、convert.iconv.*、mcrypt.*),支援鏈式疊加stream_socket_client 替代 fsockopen 發送 HTTP POST<?php
$post = ['author' => 'Gonn', 'mail' => 'gonn@nowamagic.net', 'text' => 'Hello'];
$data = http_build_query($post);
$fp = stream_socket_client('tcp://nowamagic.net:80', $errno, $errstr, 3);
if (!$fp) die("連線失敗: $errstr ($errno)");
$out = "POST /news/1/comment HTTP/1.1\r\n";
$out .= "Host: nowamagic.net\r\n";
$out .= "Content-Type: application/x-www-form-urlencoded\r\n";
$out .= "Content-Length: " . strlen($data) . "\r\n";
$out .= "Connection: Close\r\n\r\n";
$out .= $data;
fwrite($fp, $out);
while (!feof($fp)) echo fgets($fp, 1280);
fclose($fp);
file_get_contents + Context 模擬 POST 請求(比 cURL 更輕量)<?php
$opts = [
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\nContent-Length: " . strlen($data),
'content' => $data,
'timeout' => 10,
]
];
$ctx = stream_context_create($opts);
$html = file_get_contents('https://api.example.com/endpoint', false, $ctx);
<?php
$fp = fopen('c:/test.txt', 'w+');
// 僅對寫入流掛載過濾器
stream_filter_append($fp, 'string.rot13', STREAM_FILTER_WRITE);
fwrite($fp, "This is a test\n");
rewind($fp);
// 讀取時未掛載過濾器,得到已加密內容
echo fread($fp, 1024); // Guvf vf n grfg
fclose($fp);
若同時掛載 STREAM_FILTER_READ | STREAM_FILTER_WRITE,讀寫自動對稱,對上層透明。
<?php
print_r(stream_get_filters());
/* 輸出範例
Array (
[0] => convert.iconv.*
[1] => mcrypt.*
[2] => mdecrypt.*
[3] => string.rot13
[4] => string.toupper
[5] => string.tolower
[6] => string.strip_tags
[7] => convert.*
) */
| 特性 | PHP Stream | Java IO |
|---|---|---|
| 核心抽象 | 封裝器 + 上下文 + 過濾器 | InputStream/OutputStream + 裝飾器模式 |
| 疊加方式 | stream_filter_append/prepend | new BufferedInputStream(new FileInputStream(...)) |
| 網路透明化 | fopen('https://...') 直接可用 | 需 URL.openStream() 或 HttpClient |
| 自定義協議 | stream_wrapper_register() | 實作 URLStreamHandler |
PHP 的 Stream 設計深受 Java 影響,但更輕量、更動態,適合 Web 請求-回應的短生命週期。
fopen('php://input') 讀取原始 POST 資料,避免 $GLOBALS['HTTP_RAW_POST_DATA'] 記憶體暴增php://temp/maxmemory:1048576 超過 1MB 自動落盤stream_wrapper_register('myproto', 'MyProtoHandler'),即可用 fopen('myproto://resource')stream_socket_enable_crypto($fp, true, STREAM_CRYPTO_METHOD_TLS_CLIENT) 升級為 TLS| 函數 | 用途 |
|---|---|
stream_context_create | 建立上下文參數 |
stream_socket_client/server | 建立 TCP/UDP/Unix 連線/監聽 |
stream_filter_append/prepend | 掛載/前置過濾器 |
stream_wrapper_register | 註冊自定義封裝器 |
stream_get_contents | 一次性讀取所有內容 |
stream_copy_to_stream | 高效流間複製(內核級零拷貝) |
stream_select | 多路複用 I/O 監聽 |
總結:掌握 Stream 意味著你擁有了處理「任何輸入/輸出」的統一鑰匙。下次需要讀取遠端 API、壓縮日誌、加密配置檔時,請先想一想:能不能用 Stream 解決?