streamWrapper::stream_metadata

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

streamWrapper::stream_metadataストリームメタデータを変更する

説明

public streamWrapper::stream_metadata(string $path, int $option, mixed $value): bool

ストリームのメタデータを設定します。ストリーム URL 上で次のいずれかの関数がコールされたときに呼び出されます。

システムによっては、これらの動作の中に利用できないものがある可能性もあります。

パラメータ

path

メタデータを設定するファイルパスあるいは URL。URL の場合は、:// 区切りの形式でなければならないことに注意しましょう。 それ以外の形式の URL には対応していません。

option

次のいずれかです。

  • STREAM_META_TOUCH (touch() に反応してコールされる)
  • STREAM_META_OWNER_NAME (chown() に反応して文字列引数つきでコールされる)
  • STREAM_META_OWNER (chown() に反応してコールされる)
  • STREAM_META_GROUP_NAME (chgrp() に反応してコールされる)
  • STREAM_META_GROUP (chgrp() に反応してコールされる)
  • STREAM_META_ACCESS (chmod() に反応してコールされる)

value

option の値が

  • STREAM_META_TOUCH の場合は、touch() 関数の二つの引数を含む配列。
  • STREAM_META_OWNER_NAME あるいは PHP_STREAM_META_GROUP_NAME の場合は、オーナーの名前を表す文字列。
  • STREAM_META_OWNER あるいは PHP_STREAM_META_GROUP の場合は、オーナーを表す整数値。
  • STREAM_META_ACCESS の場合は、chmod() への引数となる整数値。

戻り値

成功した場合に true を、失敗した場合に false を返します。 option が実装されていない場合は false を返さなければなりません。

参考

  • touch() - ファイルの最終アクセス時刻および最終更新日をセットする
  • chmod() - ファイルのモードを変更する
  • chown() - ファイルの所有者を変更する
  • chgrp() - ファイルのグループを変更する

関連キーワード:  変更, ストリーム, メタデータ, コール, streamWrapper, 反応, stream, chgrp, option, chown