(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::stream_open — 打开文件或 URL
此方法在包装器初始化后立即调用(例如,由 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
应设置为实际打开的文件/资源的完整路径。
如果此方法调用失败(即未实现),则发出 E_WARNING
。
注意:
如果将有效的上下文传递给调用函数,则会更新 streamWrapper::$context 属性。