streamWrapper::stream_metadata

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

streamWrapper::stream_metadata — Change stream metadata

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

This method is called to set metadata on the stream. It is called when one of the following functions is called on a stream URL:

Please note that some of these operations may not be available on your system.

path

The file path or URL to set metadata. Note that in the case of a URL, it must be a :// delimited URL. Other URL forms are not supported.

option

One of:

STREAM_META_TOUCH (The method was called in response to touch())
STREAM_META_OWNER_NAME (The method was called in response to chown() with string parameter)
STREAM_META_OWNER (The method was called in response to chown())
STREAM_META_GROUP_NAME (The method was called in response to chgrp())
STREAM_META_GROUP (The method was called in response to chgrp())
STREAM_META_ACCESS (The method was called in response to chmod())

value

If option is

STREAM_META_TOUCH: Array consisting of two arguments of the touch() function.
STREAM_META_OWNER_NAME or STREAM_META_GROUP_NAME: The name of the owner user/group as string.
STREAM_META_OWNER or STREAM_META_GROUP: The value owner user/group argument as int.
STREAM_META_ACCESS: The argument of the chmod() as int.

成功时返回 true，或者在失败时返回 false。 If option is not implemented, false should be returned.