PHP stream_get_filters 怎样列出当前已注册的流过滤器

调用无参数的 stream_get_filters()，即可得到当前 PHP 执行环境中已注册流过滤器名称组成的索引数组。遍历数组就能逐项显示；如果只是为了比对环境，可以先对返回值的副本排序。这个函数不需要文件句柄，也不会读取文件内容或给流附加过滤器。

我会把它作为“先看当前环境提供了什么”的入口：先明确运行位置，再读取名称，最后决定是否调查扩展配置或应用注册逻辑。列表中的名字表示注册入口，不代表已经展开了每个过滤器族的全部具体用法。

PHP 官方地址：https://www.php.net/

先确定要查的是过滤器名称

流过滤器负责对流数据进行处理，包装器则涉及资源访问入口。想看过滤器名称，用 stream_get_filters()；想看已注册包装器名称，用 stream_get_wrappers()。两者都返回名称列表，但不是同一张表。

例如，过滤器注册表可能包含带通配符的名称。这样的条目应按名称模式理解，不能直接把星号替换成任意后缀就断言该操作可用。本文只做名称发现和记录，不实现自定义过滤器，也不执行内容转换。

在当前入口读取并整理列表

下面是独立的 CLI 示例，可保存为 list-filters.php。示例供读者在自己的 PHP 环境执行；这里不展示虚构的固定输出清单。

正常情况下，每行对应数组中的一个名称。数组的数量、内容和原始排列不应被当作跨环境不变的契约；业务需要某个名字时，应围绕名字判断，而不是读取“第几个元素”。排序也只是让展示更稳定，不会安装或激活过滤器。

把过滤器族和具体名称分开看

列表里查不到某个完整字符串，并不总能推导出对应过滤器操作不可用。有的注册入口使用通配符匹配多个名称，自定义过滤器的官方示例也展示了这种方式。因此，要区分两个问题：这个字符串是否作为独立条目出现在数组中，以及某个具体过滤器名称能否创建并用于目标流。

in_array() 的第三个参数开启严格比较，避免把名称当成其他类型匹配。这里变量特意叫 $listedExactly，不用“功能一定可用”之类的命名。若条目是某个过滤器族，返回 false 只说明没有完全相同的数组元素。

同样，看到条目也不等于所有使用参数、数据方向或输入内容都正确。真正附加过滤器属于下一项任务，应结合对应过滤器文档、具体名称和附加操作的返回值处理，不能用这份名单替代。

保存同一执行环境的诊断快照

当 CLI 和 Web 请求看到不同名单时，我更愿意先保留“在哪里查到”的信息。仅比较两张没有上下文的名称截图，容易把 PHP 版本、SAPI、配置文件或应用初始化差异混在一起。

以下示例适用于 PHP 7.3 及以上，将名称和环境字段写成一份 JSON 文本。ini_loaded 只记录主配置文件，不能代表全部扫描配置；路径字段只适合受控诊断日志，不应暴露到公共页面。

 PHP_VERSION,
    'sapi' => PHP_SAPI,
    'ini_loaded' => $mainIni === false ? null : $mainIni,
    'filters' => $filters,
];

try {
    // 编码失败时明确报错，避免把空白输出误认为空列表。
    echo json_encode(
        $snapshot,
        JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR
    ), PHP_EOL;
} catch (JsonException $error) {
    error_log('流过滤器诊断快照编码失败');
    exit(1);
}

在已有 Web 应用中，应把采集逻辑接入受控日志或内部诊断通道，不直接输出到正常响应里。框架是否完成启动、应用是否注册了自定义过滤器，也属于观察范围；独立脚本没有加载应用，自然不能据此断言应用注册逻辑未生效。

按目标选择后续动作

我建议把后续工作分成三个明确目的，避免为了列名单而引入文件写入、网络请求或自定义类。

• 只想知道有哪些名称：保留最小查询和逐行展示即可，不必建立流。
• 对比部署环境：在相同应用阶段采集快照，先看版本、SAPI 和配置上下文，再比较排序后的名称集合。
• 准备使用某个过滤器：查该过滤器的具体名称和参数，并在真正附加时处理失败；列表查询只提供发现线索。

如果某个条目仅在应用初始化后出现，就继续追踪注册调用，而不是盲目改系统配置。stream_filter_register() 用于注册用户定义过滤器，与查询函数不同；重复注册已有名称会失败，不能把重复调用当成“刷新名单”的方法。

常见误区与速查表

需要传文件路径或资源句柄吗？

不需要。函数没有参数，它查询当前环境的注册信息，不检查某个文件已经附加了哪些过滤器。

为什么官方示例和我的名单不一样？

官方可用过滤器说明明确指出，不同 PHP 环境可能比文档列出的更多或更少。应使用自己目标环境中的结果，不硬编码文档示例的完整名单。

它会列出已创建的过滤器实例吗？

不会。这里得到的是已注册名称，不是流句柄上的实例、实例状态或转换结果。

对这一类诊断，我的取舍是让发现逻辑足够小：用当前入口查询，用名称数组表达结果，用环境字段解释差异。这样既能快速列名单，也能保留后续追查所需的上下文。

参考官方文档：stream_get_filters、可用流过滤器说明、stream_filter_register、stream_get_wrappers。