array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'streamwrapper.url-stat.php', 1 => 'streamWrapper::url_stat', 2 => 'ファイルについての情報を取得する', ), 'up' => array ( 0 => 'class.streamwrapper.php', 1 => 'streamWrapper', ), 'prev' => array ( 0 => 'streamwrapper.unlink.php', 1 => 'streamWrapper::unlink', ), 'next' => array ( 0 => 'ref.stream.php', 1 => 'ストリーム 関数', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/stream/streamwrapper/url-stat.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

streamWrapper::url_stat

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::url_stat — ファイルについての情報を取得する

説明

public streamWrapper::url_stat(string $path, int $flags): array|false

このメソッドは、すべての stat() 関連の関数に対応してコールされます。

パラメータ

path

情報を取得したいファイルの URL。 URL の区切り文字は :// でなければならないことに注意しましょう。 それ以外の形式の URL はサポートしていません。

flags

ストリーム API が設定する追加のフラグ。以下の値の OR で組み合わせて使用します。
Flag Description
STREAM_URL_STAT_LINK 他のリソースへのリンクを行うことができるリソース (たとえば HTTP Location: による転送やファイルシステムのシンボリックリンク)。 このフラグを指定すると、リンク先のリソースの情報ではなくリンクそのものの情報のみを返します。 このフラグは、lstat()、 is_link() あるいは filetype() に対応して設定されます。
STREAM_URL_STAT_QUIET このフラグが設定されると、ラッパーが一切エラーを発生しなくなります。 フラグが設定されていない場合、 パス情報の取得中に発生したエラーは trigger_error() を用いて通知します。

戻り値

stat() が返すのと同じ要素を持つ配列を返さなければなりません。 未知の値、あるいは取得できない値については適切な値 (通常は 0) を設定します。 stat() 関数で説明されている mode には特別な注意を払ってください。 失敗した場合は、false を返します。

エラー / 例外

このメソッドのコールに (未実装などの理由で) 失敗した場合、 E_WARNING を発行します。

注意

注意:

有効なコンテキストがコール元関数に渡された場合に streamWrapper::$context プロパティが更新されます。

参考