stream_context_create() 配置不当会导致流中断，因默认超时60秒、无分块缓冲、ignore_errors掩盖错误，且timeout与http.timeout混用、SSL证书未配置、大文件未流式读取。
PHP 处理大数据流时，stream_context_create() 不是“可选技巧”，而是必须精细控制的环节；默认上下文在大文件、慢网络或长连接场景下极易触发超时、内存溢出或截断响应。
为什么 stream_context_create() 配置不当会导致流中断
PHP 的流函数（如 fopen()、file_get_contents()、curl 封装）在无显式上下文时使用默认设置：超时通常为 60 秒，max_redirects 为 20，且不启用分块读取缓冲。对几百 MB 的 API 响应或持续推送的 CSV 流，这些值根本不够用。
-
timeout和http.timeout是两套参数：前者影响底层 socket 连接与读写，后者仅作用于 HTTP 封装层（且部分 PHP 版本中被忽略） - 未设置
buffer或设为0时，stream_get_contents()可能一次性把整个响应载入内存，OOM 直接崩溃 -
ignore_errors设为true后，即使 HTTP 状态码是 4xx/5xx，file_get_contents()仍返回 body —— 容易掩盖服务端错误
处理 GB 级文件下载的最小安全上下文配置
核心原则：禁用自动缓存、启用手动分块、分离连接与读取超时。
$context = stream_context_create([
'http' => [
'method' => 'GET',
'timeout' => 300, // socket 层总超时（秒）
'ignore_errors' => false,
'protocol_version' => 1.1,
'header' => "Accept: application/octet-stream\r\n",
],
'ssl' => [
'verify_peer' => true,
'cafile' => '/path/to/cacert.pem',
],
]);
- 不要依赖
http.timeout—— 它在 PHP 7.3+ 中已被标记为废弃，实际行为不稳定 - 若目标是 HTTPS，
ssl子数组必须显式提供cafile，否则自签名或私有 CA 证书会拒绝连接 - 下载时别用
file_get_contents()，改用fopen()+fread()循环，每次最多读 8192 字节
用 stream_filter_append() 边读边解压或转码
遇到 gzip 压缩的 JSON 流或 UTF-16 日志，不能等全部下载完再处理 —— 内存扛不住。此时需在流打开后立即挂载过滤器。
立即学习“PHP免费学习笔记（深入）”；
$fp = fopen('https://api.example.com/large.json.gz', 'r', false, $context);
stream_filter_append($fp, 'zlib.inflate', STREAM_FILTER_READ);
// 后续用 fgets() 或 stream_get_line() 逐行读，解压实时发生
- 过滤器名必须严格匹配：
zlib.inflate（不是zlib.decode），convert.iconv.UTF-16LE/UTF-8 -
STREAM_FILTER_READ只影响读操作，不影响写；若同时读写，需分别附加 - 过滤器无法回退 —— 一旦挂载，所有后续读取都经过它，调试时容易误判数据来源
常见报错与对应修复点
Warning: file_get_contents(): failed to open stream: HTTP request failed! —— 这不是网络问题，而是上下文里没配 ignore_errors 或 timeout 过短，导致 408/503 被当异常抛出。
-
failed to open stream: Connection timed out→ 检查timeout是否设在http数组外层（正确），而非http.timeout（无效） -
SSL operation failed with code 1→ssl.cafile路径错、权限不足，或用了verify_peer => false却没关verify_peer_name - 读到一半流关闭 → 服务端启用了 HTTP/2 推送或分块传输，但 PHP 流不支持自动 reassemble，需手动检查
stream_get_meta_data($fp)['timed_out']并重连
真正麻烦的从来不是怎么配参数，而是你得知道哪个参数在哪一层生效、哪个版本开始失效、以及服务端悄悄返回了 Transfer-Encoding: chunked 时，PHP 流底层是否真理解它。
