萬盛學電腦網

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

PHP Stream 流操作全面指南:從基礎到進階實戰

什麼是 Stream?

Stream(流) 是 PHP 中最強大却常被忽視的功能之一。它源於 UNIX 管道概念,將「資料來源」與「處理邏輯」解耦:無論是檔案、網路連線、壓縮資料、加密通道,統統可用統一的 fopen/fread/fwrite/fclose 介面操作。PHP 內建支援 file://、https://、ftp://、php://、zlib://、data:// 等多種協議封裝器。

核心概念三要素

  1. 封裝器:定義如何存取資料源(如 http、ftp、compress.zlib)
  2. 上下文:stream_context_create() 建立的參數包,控制 HTTP header、SSL 驗證、超時、代理等
  3. 過濾器:掛載在讀寫管道上的轉換層(如 string.rot13、convert.iconv.*、mcrypt.*),支援鏈式疊加

實戰範例速覽

1. 使用 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);

2. 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);

3. 過濾器鏈:寫入時自動 ROT13 加密,讀出自動解密

<?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,讀寫自動對稱,對上層透明。

4. 列出系統支援的所有過濾器

<?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.*
) */

Stream 與 Java IO 的異同

特性PHP StreamJava IO
核心抽象封裝器 + 上下文 + 過濾器InputStream/OutputStream + 裝飾器模式
疊加方式stream_filter_append/prependnew 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 解決?

copyright © 萬盛學電腦網 all rights reserved