(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
stream_get_meta_data — 從封裝協(xié)議文件指針中取得報頭/元數據
$fp
): array
返回現有 stream
的信息??梢允侨魏瓮ㄟ^(guò)
fopen(),fsockopen()
和 pfsockopen() 建立的流。返回的數組包含以下項目:
timed_out
(bool) - 如果在上次調用
fread() 或者 fgets()
中等待數據時(shí)流超時(shí)了則為 true
。
blocked
(bool) - 如果流處于阻塞
IO 模式時(shí)為 true
。參見(jiàn) stream_set_blocking()。
eof
(bool) - 如果流到達文件末尾時(shí)為
true
。注意對于 socket 流甚至當 unread_bytes
為非零值時(shí)也可以為 true
。要測定是否有更多數據可讀,用
feof() 替代讀取本項目的值。
unread_bytes
(int) - 當前在 PHP 自己的內部緩沖區中的字節數。
注意: 不要在腳本中使用此值。
以下項目是 PHP 4.3 新加的:
stream_type
(string) - 一個(gè)描述流底層實(shí)現的標注。
wrapper_type
(string) -
一個(gè)描述流的分層協(xié)議封裝實(shí)現的標注。更多關(guān)于封裝協(xié)議的信息見(jiàn)
支持的協(xié)議和封裝協(xié)議。
wrapper_data
(mixed) -
當前流附加的封裝協(xié)議數據。更多封裝協(xié)議及其數據的信息見(jiàn)
支持的協(xié)議和封裝協(xié)議。
filters
(array) -
包含有被疊加在當前流的任何過(guò)濾器名的數組。過(guò)濾器的文檔見(jiàn)附錄中的可用過(guò)濾器列表。
注意:
本函數是 PHP 4.3 引進(jìn)的,在此版本之前,可以用 socket_get_status() 來(lái)取得前四個(gè)項目并且僅能用于基于 socket 的流。
在 PHP 4.3 及以后版本中,socket_get_status() 是本函數的別名。
注意: 本函數不能作用于通過(guò) Socket 擴展庫創(chuàng )建的流。
以下項目為 PHP 5.0 新加:
mode
(string) - 對當前流所要求的訪(fǎng)問(wèn)類(lèi)型(見(jiàn)
fopen() 中的表格 1)。
seekable
(bool) - 是否可以在當前流中定位。
uri
(string) - 與當前流關(guān)聯(lián)的 URI 或文件名。