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