stream_get_meta_data 可以识别流的协议类型吗？使用方法解析

gitbox 2025-07-17

在 PHP 中，stream_get_meta_data() 是一个非常有用的函数，它用于获取与流（stream）相关的各种元信息。很多开发者在使用该函数时，会好奇：

本文将对这个问题进行解析，并结合使用示例说明 stream_get_meta_data() 的实际功能和限制。

stream_get_meta_data() 能识别协议类型吗？

简短回答是：不能直接识别协议类型。

虽然 stream_get_meta_data() 返回了很多有用的信息，如是否到达文件末尾（eof）、是否阻塞（blocked）、是否可读/可写等，但它不会直接返回流的协议类型。协议类型的信息实际上在创建流时已隐含在流资源中，但并不通过该函数暴露。

举个例子：

<span><span><span class="hljs-variable">$fp</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">"http://example.com"</span></span><span>, </span><span><span class="hljs-string">"r"</span></span><span>);
</span><span><span class="hljs-variable">$meta</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stream_get_meta_data</span></span><span>(</span><span><span class="hljs-variable">$fp</span></span><span>);

</span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$meta</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$fp</span></span><span>);
</span></span>

返回的 $meta 数据结构大致如下：

<span><span><span class="hljs-title function_ invoke__">Array</span></span><span>
(
    [wrapper_type] =&gt; http
    [stream_type] =&gt; tcp_socket
    [mode] =&gt; r
    [unread_bytes] =&gt; </span><span><span class="hljs-number">0</span></span><span>
    [seekable] =&gt; 
    [uri] =&gt; </span><span><span class="hljs-attr">http</span></span><span>://example.com
    [timed_out] =&gt; 
    [blocked] =&gt; </span><span><span class="hljs-number">1</span></span><span>
    [eof] =&gt; 
)
</span></span>

其中的 wrapper_type 就是最接近“协议类型”的一个字段，比如 http、ftp、php 等。虽然这并不是专门用于协议识别的字段，但我们可以间接通过它来判断流使用了哪种协议。

wrapper_type 和 stream_type 的意义

wrapper_type: 这个字段表示流的封装类型，也就是 PHP 使用的“包装器”，常常与协议相关。常见的值包括 http、ftp、php、plainfile 等。
stream_type: 更低层次的表示，比如 tcp_socket、ssl、STDIO 等，反映了实际传输方式。

如果你希望识别“协议”这个层面的信息，建议优先查看 wrapper_type 字段。

如何通过 wrapper_type 判断协议？

你可以封装一个辅助函数，用来提取并返回协议信息。例如：

<span><span><span class="hljs-function"><span class="hljs-keyword">function</span></span></span><span> </span><span><span class="hljs-title">getStreamProtocol</span></span><span>(</span><span><span class="hljs-params"><span class="hljs-variable">$stream</span></span></span><span>) {
    </span><span><span class="hljs-variable">$meta</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stream_get_meta_data</span></span><span>(</span><span><span class="hljs-variable">$stream</span></span><span>);
    </span><span><span class="hljs-keyword">return</span></span><span> </span><span><span class="hljs-variable">$meta</span></span><span>[</span><span><span class="hljs-string">'wrapper_type'</span></span><span>] ?? </span><span><span class="hljs-literal">null</span></span><span>;
}
</span></span>

使用示例：

<span><span><span class="hljs-variable">$stream</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">'php://input'</span></span><span>, </span><span><span class="hljs-string">'r'</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">getStreamProtocol</span></span><span>(</span><span><span class="hljs-variable">$stream</span></span><span>); </span><span><span class="hljs-comment">// 输出: php</span></span><span>
</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$stream</span></span><span>);
</span></span>

通过这个方式，你就可以基本判断流的协议来源。

总结

虽然 stream_get_meta_data() 并不会显式地返回协议名称，但它返回的 wrapper_type 字段足以帮助开发者判断使用的协议或包装器类型。这种间接识别方式在实际开发中已经非常实用。

小提示：在处理多种类型流资源时，务必注意兼容性和异常处理，尤其是涉及网络或远程流时。

stream_get_meta_data