streamWrapper::stream_open()
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
Opens file or URL
说明
public streamWrapper::stream_open(string $path,string $mode,int $options,string &$opened_path): bool
This method is called immediately after the wrapper is initialized (f.e.byfopen()andfile_get_contents()).
参数
- $path
Specifies the URL that was passed to the original function.
Note:
The URL can be broken apart withparse_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 forfopen().
Note:
Remember to check if the$modeis valid for the$pathrequested.
- $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$pathis relative, search for the resource using the include_path. STREAM_REPORT_ERRORS
If this flag is set, you are responsible for raising errors usingtrigger_error()during opening of the stream. If this flag is not set, you should not raise any errors. - $opened_path
If the$pathis opened successfully,and
STREAM_USE_PATH
is set in$options,$opened_pathshould be set to the full path of the file/resource that was actually opened.
返回值
成功时返回TRUE
,或者在失败时返回FALSE
。
错误/异常
调用此方法失败将给出E_WARNING
(未实现)。
注释
Note:当合法的上下文传递给调用函数时,属性streamWrapper::$context会被改变。
参见
fopen()
打开文件或者 URLparse_url()
解析 URL,返回其组成部分