(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_open — Opens file or URL
$path
, string $mode
, int $options
, string|null &$opened_path
) : boolThis method is called immediately after the wrapper is initialized (f.e. by fopen() and file_get_contents()).
pathSpecifies the URL that was passed to the original function.
Note:
The URL can be broken apart with parse_url(). Note that only URLs delimited by :// are supported. : and :/ while technically valid URLs, are not.
modeThe mode used to open the file, as detailed for fopen().
Note:
Remember to check if the
modeis valid for thepathrequested.
optionsHolds 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（未实现）。
Note:
当合法的上下文传递给调用函数时，属性 streamWrapper::$context 会被改变。