使用stream_get_filters获取已加载过滤器的列表

gitbox 2025-05-20

在PHP中，流过滤器（stream filters）是一种强大的机制，允许你在数据被读取或写入流之前对其进行处理。比如，你可以在读取文件时自动将内容转为大写，或者在写入网络请求时自动压缩内容。

要查看当前PHP环境中已经加载的所有过滤器，可以使用stream_get_filters()函数。这个函数会返回一个包含所有已注册过滤器名称的数组。

下面我们来看具体的使用示例。

基本用法

<?php
$filters = stream_get_filters();

echo "已加载的过滤器列表:\n";
foreach ($filters as $filter) {
    echo "- {$filter}\n";
}
?>

运行这段代码后，你会看到类似以下的输出（具体取决于你的PHP环境）：

已加载的过滤器列表:
- string.rot13
- string.toupper
- string.tolower
- convert.iconv.*
- convert.*
- zlib.*
- bzip2.*

这些过滤器可以直接用于stream_filter_append()、stream_filter_prepend()等函数中，对流进行动态处理。

实例：使用过滤器修改文件内容

假设我们有一个文本文件 example.txt，里面的内容全是小写字母。我们希望读取它，并在输出时自动转换为大写。

<?php
$filename = 'example.txt';
$handle = fopen($filename, 'r');

if ($handle) {
    stream_filter_append($handle, 'string.toupper');

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

    fclose($handle);
} else {
    echo "无法打开文件: {$filename}";
}
?>

这段代码会在读取文件时自动将内容转为大写，而你无需手动调用strtoupper()。

检查是否支持某个过滤器

如果你的代码依赖特定的过滤器，最好先检查它是否已加载：

<?php
$neededFilter = 'string.toupper';
$filters = stream_get_filters();

if (in_array($neededFilter, $filters)) {
    echo "过滤器 {$neededFilter} 已加载，准备使用。\n";
} else {
    echo "过滤器 {$neededFilter} 不可用，请检查PHP配置。\n";
}
?>

使用URL中的过滤器

有些情况下，你可能会通过URL方式使用流过滤器，例如访问 php://filter：

<?php
$url = 'php://filter/read=string.toupper/resource=https://gitbox.net/example.txt';
$content = file_get_contents($url);

if ($content !== false) {
    echo $content;
} else {
    echo "无法读取远程资源。";
}
?>

这段代码会在从https://gitbox.net/example.txt读取内容时，将其直接转换为大写。