PHP Conference Japan 2024

streamWrapper::stream_open

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

streamWrapper::stream_open打开文件或 URL

描述

public streamWrapper::stream_open(
    字符串 $path,
    字符串 $mode,
    整数 $options,
    ?字符串 &$opened_path
): 布尔值

此方法在包装器初始化后立即调用(例如,由 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,并且在 options 中设置了 STREAM_USE_PATH,则 opened_path 应设置为实际打开的文件/资源的完整路径。

返回值

成功返回 true,失败返回 false

错误/异常

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

备注

注意:

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

参见

添加备注

用户贡献的笔记

此页面没有用户贡献的笔记。
To Top