在线文档教程
PHP
流 | Streams

streamWrapper::stream_open

streamWrapper::stream_open

(PHP 4 >= 4.3.2, PHP 5, PHP 7)

streamWrapper::stream_open - 打开文件或URL

描述

public bool streamWrapper::stream_open ( string $path , string $mode , int $options , string &$opened_path )

这个方法在包装器初始化后立即被调用(通过fopen()和file_get_contents())。

参数

path

指定传递给原始函数的URL。

注意:URL可以用parse_url()分解。请注意,只支持由//分隔的网址。和/虽然技术上有效的URL,但不是。

mode

用于打开文件的模式,详见fopen()。

注意:请记得检查是否modepath请求有效。

options

保留由流API设置的附加标志。它可以保存一个或多个以下值或'一起'。

Flag描述
STREAM_USE_PATH如果路径是相对的,则使用include_path搜索资源。
STREAM_REPORT_ERRORS如果设置了此标志,则在打开流期间,您有责任使用trigger_error()引发错误。如果这个标志没有设置,你不应该提出任何错误。

opened_path

如果path成功打开,并STREAM_USE_PATH设置在optionsopened_path应设置为实际被打开的文件/资源的完整路径。

返回值

成功时返回TRUE或失败时返回FALSE

错误/异常

如果对此方法的调用失败(即未实现),则发出E_WARNING

注意

注意:如果将有效的上下文传递给调用方函数,则会更新streamWrapper::$context属性。

另请参阅

  • fopen() - 打开文件或URL

  • parse_url() - 解析URL并返回其组件

← streamWrapper::stream_metadata

streamWrapper::stream_read →