如何在PHP中使用stream_get_filters獲取輸入流的過濾器？

gitbox 2025-05-27

在PHP 中， stream_get_filters()是一個非常有用的函數，它允許你查看當前可用的流過濾器。流過濾器可以用來在數據被讀取或寫入時，對其進行某種轉換或處理，比如壓縮、加密、編碼等。本文將介紹如何使用stream_get_filters()來查看這些過濾器，並演示一個簡單的應用實例。

一、什麼是流過濾器？

流過濾器是PHP 流封裝器（stream wrapper）的一部分，用於在流數據傳輸過程中對數據進行動態處理。例如，你可以在將數據寫入文件前對其進行壓縮，或者在從文件中讀取數據時自動解壓縮。

常見的過濾器包括：

string.rot13 ：對字符串進行ROT13 編碼。
string.toupper ：將字符串轉換為大寫。
string.tolower ：將字符串轉換為小寫。
convert.base64-encode和convert.base64-decode ：對數據進行Base64 編碼或解碼。

二、使用stream_get_filters()查看可用過濾器

你可以使用stream_get_filters()函數獲取一個數組，裡面列出了當前PHP 環境中所有可用的流過濾器：

 <?php
$filters = stream_get_filters();
echo "可用的流過濾器：\n";
print_r($filters);
?>

運行這段代碼後，你會得到類似如下輸出：

 可用的流過濾器：
Array
(
    [0] => zlib.*
    [1] => string.rot13
    [2] => string.toupper
    [3] => string.tolower
    [4] => convert.*
)

注意：不同的PHP 安裝可能列出的過濾器不同，取決於安裝的擴展模塊。

三、實際應用：對文件寫入使用過濾器

下面我們來演示一個使用過濾器將文件內容轉換為大寫的例子。

 <?php
$filename = 'output.txt';
$fp = fopen($filename, 'w');

// 在寫入時應用 string.toupper 過濾器
stream_filter_append($fp, 'string.toupper');

fwrite($fp, "hello, gitbox.net!\n");
fwrite($fp, "this is a test.\n");

fclose($fp);

echo "寫入完成，請檢查文件 $filename。\n";
?>

這段代碼會創建一個output.txt文件，寫入時自動把所有字母轉換為大寫。你打開文件後，內容會是：

 HELLO, GITBOX.NET!
THIS IS A TEST.

四、使用URL 流和過濾器結合

PHP 不僅可以操作本地文件流，還能用fopen()打開URL 流（如果允許allow_url_fopen ）。例如：

 <?php
$url = 'https://gitbox.net/data.txt';
$fp = fopen($url, 'r');

// 在讀取時應用 ROT13 過濾器
stream_filter_append($fp, 'string.rot13');

while (!feof($fp)) {
    echo fgets($fp);
}

fclose($fp);
?>

假設https://gitbox.net/data.txt上的內容是普通文本，這段代碼會實時把內容用ROT13 編碼後輸出。