stream_get_meta_data

(PHP 4 >= 4.3.0, PHP 5)

stream_get_meta_data -- 从封装协议文件指针中取得报头/元数据

说明

mixed stream_get_meta_data ( int fp )

返回现有 stream 的信息。可以是任何通过 fopen()fsockopen()pfsockopen() 建立的流。返回的数组包含以下项目:

  • timed_out (bool) - 如果在上次调用 fread() 或者 fgets() 中等待数据时流超时了则为 TRUE

  • blocked (bool) - 如果流处于阻塞 IO 模式时为 TRUE。参见 socket_set_blocking()

  • eof (bool) - 如果流到达文件末尾时为 TRUE。注意对于 socket 流甚至当 unread_bytes 为非零值时也可以为 TRUE。要测定是否有更多数据可读,用 feof() 替代读取本项目的值。

  • unread_bytes (int) - 当前读取缓冲区中的字节数。

以下项目是 PHP 4.3 新加的:

  • stream_type (string) - 一个描述流底层实现的标注。

  • wrapper_type (string) - 一个描述流的分层协议封装实现的标注。更多关于封装协议的信息见 附录 L

  • wrapper_data (mixed) - 当前流附加的封装协议数据。更多封装协议及其数据的信息见 附录 L

  • filters (array) - 包含有被叠加在当前流的任何过滤器名的数组。过滤器目前没有文档。

注: 本函数是 PHP 4.3 引进的,在此版本之前,可以用 socket_get_status() 来取得前四个项目并且仅能用于基于 socket 的流

在 PHP 4.3 及以后版本中,socket_get_status() 是本函数的别名。

注: 本函数不能作用于通过 Socket 扩展库创建的流。


add a note add a note User Contributed Notes
ed at readinged dot com
29-Jan-2003 11:54
Below is a function I wrote to pull the "Last-Modified" header from a given URL.  In PHP version 4.3 and above, it takes advantage of the stream_get_meta_data function, and in older version it uses a conventional GET procedure.  On failure to connect to $url, it returns NULL.  If the server does not return the Last-Modified header, it returns the current time.  All times are returned in PHP's integer format (seconds since epoch).

Use it as so:

$last_modified = stream_last_modified('http://www.php.net/news.rss');
if (!is_null($last_modified))
   if ($last_modified < time()-3600) //Older than an hour
     echo 'URL is older than an hour.';
   else
     echo 'URL is fairly new.';
else
   echo 'Invalid URL!';

function stream_last_modified($url)
{
   if (function_exists('version_compare') && version_compare(phpversion(), '4.3.0') > 0)
   {
     if (!($fp = @fopen($url, 'r')))
         return NULL;

     $meta = stream_get_meta_data($fp);
     for ($j = 0; isset($meta['wrapper_data'][$j]); $j++)
     {
         if (strstr(strtolower($meta['wrapper_data'][$j]), 'last-modified'))
         {
           $modtime = substr($meta['wrapper_data'][$j], 15);
           break;
         }
     }
     fclose($fp);
   }
   else
   {
     $parts = parse_url($url);
     $host  = $parts['host'];
     $path  = $parts['path'];

     if (!($fp = @fsockopen($host, 80)))
         return NULL;

     $req = "HEAD $path HTTP/1.0\r\nUser-Agent: PHP/".phpversion()."\r\nHost: $host:80\r\nAccept: */*\r\n\r\n";
     fputs($fp, $req);

     while (!feof($fp))
     {
         $str = fgets($fp, 4096);
         if (strstr(strtolower($str), 'last-modified'))
         {
           $modtime = substr($str, 15);
           break;
         }
     }
     fclose($fp);
  }
   return isset($modtime) ? strtotime($modtime) : time();
}