stream_get_meta_data

(PHP 4 >= 4.3.0, PHP 5)

stream_get_meta_data — ヘッダーあるいはメタデータをストリームまたはファイルポインタから取得する

説明

array stream_get_meta_data ( resource $stream )

既存の stream に関する情報を返します。

パラメータ

stream: ストリームは fopen() か、 fsockopen() か、pfsockopen() で作成されたいずれのものも指定できます。

返り値

結果の配列は次のような項目を含みます。

timed_out (bool) - 最後に fread() または fgets() でデータを待っている時にタイムアウトした場合 TRUE を返します。
blocked (bool) - ストリームがブロック I/O モードの場合に TRUE となります。 stream_set_blocking() を参照ください。
eof (bool) - ストリームが EOF に達した時 TRUE となります。ストリームがソケットベースの場合、このメンバーは、たとえ unread_bytes が 0 でなくても TRUE になる場合があることに注意してください。まだデータがあるかどうかを調べるには、このパラメータではなく、 feof() を使ってください。
unread_bytes (int) - PHP の内部バッファにあるデータのバイト数。

注意: スクリプト中でこの値を使用してはいけません。
stream_type (string) - ストリームの下層にある実装を表すラベル
wrapper_type (string) - ストリームを覆うプロトコルラッパを表すラベル。ラッパについてはサポートするプロトコル/ラッパーを参照ください。
wrapper_data (mixed) - ストリームに付随しているラッパの固有のデータ。ラッパとその固有の情報については、サポートするプロトコル/ラッパーを参照ください。
filters (array) - ストリームに付加されているフィルタの名称を格納した配列。フィルタに関するドキュメントは利用できるフィルタのリストにあります。
mode (string) - このストリームに要求されるアクセスモード（fopen() リファレンスの表 1 を参照ください）。
seekable (bool) - 現在のストリーム内で移動が可能かどうか。
uri (string) - このストリームに関連付けられた URI / ファイル名。

変更履歴

バージョン	説明
5.0.0	次の項目が返り値の配列に追加されました。 mode、seekable および uri。
4.3.0	次の項目が返り値の配列に追加されました。 stream_type、wrapper_type、 wrapper_data および filters。
4.3.0	socket_get_status() がこの関数のエイリアスとなりました。 PHP 4.3.0 より前のバージョンでは、この関数は最初の 4 つの項目を取得する関数でソケットベースのストリームでしか使えませんでした。

例

例1 stream_get_meta_data() の例


<?php
$url = 'http://www.example.com/';

if (!$fp = fopen($url, 'r')) {
    trigger_error("Unable to open URL ($url)", E_USER_ERROR);
}

$meta = stream_get_meta_data($fp);

print_r($meta);

fclose($fp);
?>

上の例の出力は、たとえば以下のようになります。

Array
(
    [wrapper_data] => Array
        (
            [0] => HTTP/1.1 200 OK
            [1] => Server: Apache/2.2.3 (Red Hat)
            [2] => Last-Modified: Tue, 15 Nov 2005 13:24:10 GMT
            [3] => ETag: "b300b4-1b6-4059a80bfd280"
            [4] => Accept-Ranges: bytes
            [5] => Content-Type: text/html; charset=UTF-8
            [6] => Set-Cookie: FOO=BAR; expires=Fri, 21-Dec-2012 12:00:00 GMT; path=/; domain=.example.com
            [6] => Connection: close     
            [7] => Date: Fri, 16 Oct 2009 12:00:00 GMT
            [8] => Age: 1164   
            [9] => Content-Length: 438
        )

    [wrapper_type] => http
    [stream_type] => tcp_socket/ssl
    [mode] => r
    [unread_bytes] => 438
    [seekable] => 
    [uri] => http://www.example.com/
    [timed_out] => 
    [blocked] => 1
    [eof] => 
)

注意

注意: この関数は、Socket 拡張モジュールで作成したソケットでは動作しません。

参考

get_headers() - HTTP リクエストに対するレスポンス内でサーバによって送出された全てのヘッダを取得する
$http_response_header

add a note User Contributed Notes
stream_get_meta_data

niels at nise81 dot com
03-Mar-2008 01:49


here is just an example how to read out all meta data.

how ever I found out that the "seekable"-entry doesn't exist in most of the streaming media files.



      if (!($fp = @fopen($url, 'r')))

         return NULL;



      $meta = stream_get_meta_data($fp);

      

          foreach(array_keys($meta) as $h){

              $v = $meta[$h];

              echo "".$h.": ".$v."<br/>";

              if(is_array($v)){

                  foreach(array_keys($v) as $hh){

                      $vv = $v[$hh];

                      echo "_".$hh.": ".$vv."<br/>";

                  }

              }

          }

      fclose($fp);

ed at readinged dot com
29-Jan-2003 03: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();

}

add a note

stream_get_transports

stream_get_line

Last updated: Fri, 13 Nov 2009