streamWrapper::stream_open

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

streamWrapper::stream_open打开文件或 URL

描述

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

此方法在包装器初始化后立即调用(例如,由 fopen()file_get_contents() 调用)。

参数

path

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

注意:

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

mode

用于打开文件的模式,如 fopen() 中所述。

注意:

请记住检查 mode 是否对请求的 path 有效。

options

保存由流 API 设置的附加标志。它可以保存以下值中的一个或多个,这些值通过 OR 运算符组合在一起。

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

opened_path

如果 path 成功打开,并且 STREAM_USE_PATHoptions 中设置,则 opened_path 应设置为实际打开的文件/资源的完整路径。

返回值

成功时返回 true,失败时返回 false

错误/异常

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

备注

注意:

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

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top