PHP - Manual: streamWrapper::stream_open
2024-12-22
(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_open — Opens file or URL
$path
,$mode
,$options
,&$opened_path
This method is called immediately after the wrapper is initialized (f.e. by fopen() and file_get_contents()).
path
Specifies the URL that was passed to the original function.
注意:
The URL can be broken apart with parse_url(). Note that only URLs delimited by :// are supported. : and :/ while technically valid URLs, are not.
mode
The mode used to open the file, as detailed for fopen().
注意:
Remember to check if the
mode
is valid for thepath
requested.
options
Holds additional flags set by the streams API. It can hold one or more of the following values OR'd together.
Flag | Description |
---|---|
STREAM_USE_PATH |
If path is relative, search
for the resource using the include_path.
|
STREAM_REPORT_ERRORS |
If this flag is set, you are responsible for raising errors using trigger_error() during opening of the stream. If this flag is not set, you should not raise any errors. |
opened_path
If the path
is opened successfully,
and STREAM_USE_PATH
is set in options
,
opened_path
should be set to the full
path of the file/resource that was actually opened.
成功时返回 true
, 或者在失败时返回 false
。
调用此方法失败将给出
E_WARNING
(未实现)。
注意:
当合法的上下文传递给调用函数时,属性 streamWrapper::$context 会被改变。
官方地址:https://www.php.net/manual/en/streamwrapper.stream-open.php