PHP stream_get_meta_data 函数详解：获取流资源元数据

功能与基础用法

该函数接受一个由 fopen()、fsockopen() 或 pfsockopen() 建立的流资源标识符作为参数。执行后返回当前流的各种属性信息。

以下代码演示了如何获取新浪首页的流元数据：

<?php
$fp = fopen("http://www.sina.com.cn", 'r');
$meta = stream_get_meta_data($fp);
print_r($meta);
?>

返回值字段详解

返回的数组包含多个键值对，不同版本的 PHP 可能引入不同的字段。以下是常见字段的详细说明：

第1步：查看包装器数据（wrapper_data）

• 类型：混合类型（通常为数组）
• 含义：包含与该流相关联的封装协议附加数据。对于 http 包装器，这通常是一个包含 HTTP 响应头的数组。
• 示例输出：

  [wrapper_data] => Array (
      [0] => HTTP/1.0 200 OK
      [1] => Server: Apache
      [2] => Content-Type: text/html
      ...
  )

第2步：识别流类型与包装器类型

• stream_type (string): 描述流底层实现的标签，例如 tcp_socket/ssl 表示这是一个 TCP Socket 连接。
• wrapper_type (string): 描述分层协议封装实现的标签，如 http 表示使用了 HTTP 协议封装。

第3步：检查模式与可搜索性

• mode (string): 流打开时使用的访问模式，如 r (只读)、w (写入) 等。
• seekable (bool): 布尔值，指示是否可以在流中进行定位操作。网络流通常为 false，本地文件通常为 true。
• uri (string): 与流关联的 URI 或文件名。

第4步：监控状态标志

• timed_out (bool): 如果在最近的读取操作中超时，则为 TRUE。
• blocked (bool): 如果流处于阻塞 I/O 模式，则为 TRUE。
• eof (bool): 如果到达文件末尾，则为 TRUE。注意：对于 socket 流，即使有未读字节也可能显示为 EOF，建议结合 feof() 使用。
• unread_bytes (int): 当前在 PHP 内部缓冲区中的剩余未读字节数。此值仅供诊断参考，不建议在业务逻辑中使用。

第5步：其他高级字段（PHP 5+）

• filters (array): 附加在当前流上的过滤器名称数组。

注意事项

1. 版本差异： 在 PHP 4.3 之前，可以使用 socket_get_status() 替代，但该函数仅适用于基于 Socket 的流。PHP 4.3 及以上版本中，socket_get_status() 已成为 stream_get_meta_data() 的别名。
2. 限制： 此函数不能作用于通过纯 Socket 扩展库直接创建的流对象，必须是通过标准 I/O 函数打开的资源。
3. 性能： 调用此函数会生成额外的系统开销，避免在高频循环中频繁调用。

总结

stream_get_meta_data() 是 PHP 开发者深入理解流行为的重要工具。通过解析其返回值，特别是 wrapper_data 中的 HTTP 响应头，可以方便地检查服务器状态、内容类型及缓存策略，无需进行复杂的原始数据解析。

以上就是 PHP stream_get_meta_data 返回值的详细内容，更多关于 PHP 流处理函数的资料请关注本站其它相关文章！