streamWrapper::stream_lock
streamWrapper::stream_open
streamWrapper
PHP Manual

# streamWrapper::stream_metadata

(PHP 5 >= 5.4.0)

streamWrapper::stream_metadata — ストリームオプションを変更する

### 説明

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

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

- touch()
- chmod()
- chown()
- chgrp()

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

> 注意: この関数は PHP 5.4.0 以降で利用できます。

### パラメータ

`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_lock
streamWrapper::stream_open
streamWrapper
PHP Manual