PHP 8.4 已弃用 stream_context_set_option() 的双参数和四参数签名，必须改用 stream_context_set_options()；后者仅接受二维关联数组（如 ['http'=>['timeout'=>5]]），且仅支持批量设置，不兼容扁平键名或单层数组。
PHP 8.4 已弃用 stream_context_set_option() 的双参数签名
PHP 8.4.0 起，stream_context_set_option($context, $wrapper, $option, $value) 这种四参数调用方式已被正式弃用；同时，更早被广泛使用的双参数签名 stream_context_set_option($context, $options)（其中 $options 是二维数组）也同步标记为弃用。官方明确要求：全部迁移到 stream_context_set_options()。
stream_context_set_options() 是唯一推荐的替代函数
它接收两个参数：$stream_or_context 和 $options，且 $options 必须是二维关联数组，结构为 $options['wrapper']['option'] = $value —— 和旧版双参数签名的数组格式完全一致，但函数名和语义更清晰。
- 兼容 PHP 7.2+，在 8.3/8.4 中是**唯一未弃用**的上下文批量设参函数
- 不接受单个 option 设置，必须传完整二维结构；想设单个值，仍需用
stream_context_set_option($context, 'http', 'timeout', 5)（该四参数形式在 8.4 仍可用，但不推荐新增使用） - 返回
true表示成功，false表示失败（如$context无效、wrapper 名拼错、option 名不存在等）
迁移时最容易踩的坑
不是改个函数名就能跑通。常见翻车点集中在数组结构和 wrapper 名匹配上：
-
$options必须是严格二维：不能是['timeout' => 5]（缺 wrapper 层），也不能是['http.timeout' => 5]（非法键名）；正确写法是['http' => ['timeout' => 5]] - wrapper 名必须准确对应协议：用
https://时，'ssl'选项要放在'ssl'子数组里，不是'https'；'http'选项才进'http'子数组 - 某些选项（如
request_fulluri）属于'http'wrapper，但若上下文同时用于file://或php://流，这些无关 wrapper 的配置会被忽略，不会报错，容易误判生效 - PHP 8.3+ 异步运行时（如 Swoole 5.0+/ext-uv）中，若
stream_context_set_options()被用于协程内创建的上下文，需确认该上下文未被其他协程复用 —— 上下文资源非线程安全，跨协程修改可能引发静默行为异常
为什么不用 stream_context_create() 替代？
它只在创建时生效，无法对已存在的流或上下文动态更新配置。典型场景如：复用一个长期存活的 $httpContext，需在每次请求前临时覆盖 header 或 timeout，这时必须用 stream_context_set_options()（或已弃用的 stream_context_set_option()）。硬切到 stream_context_create() 意味着放弃上下文复用，可能触发连接池失效、TLS 会话复用丢失等问题。
立即学习“PHP免费学习笔记（深入）”；
