file_get_contents设置超时必须用stream_context_create，因函数本身不支持timeout参数；需通过stream_context_create构造含http timeout和ignore_errors选项的上下文，并对HTTPS补ssl配置，否则可能卡死。
file_get_contents 设置超时必须用 stream_context_create
PHP 的 file_get_contents 本身不接受超时参数，直接传 timeout 会忽略。必须通过 stream_context_create 构造上下文，再传给 file_get_contents 的第三个参数。
常见错误是写成：file_get_contents($url, false, 5) —— 这里的 5 是 resource 类型的第三个参数，不是超时值，会直接报错或返回 false。
- 超时单位是秒，支持浮点数（如
3.5） - 必须同时设置
timeout和ignore_errors（可选但建议设为true，避免 HTTP 错误码直接触发警告） - 如果请求 HTTPS，还需显式启用
ssl上下文（否则可能卡住或报 SSL 相关 warning）
最简可用的超时配置示例
以下代码能稳定控制超时，并捕获连接失败：
$opts = [
'http' => [
'method' => 'GET',
'timeout' => 5,
'ignore_errors' => true,
]
];
$context = stream_context_create($opts);
$result = file_get_contents('https://api.example.com/data', false, $context);
if ($result === false) {
// 检查是否因超时失败
$meta = stream_get_meta_data($context);
if (isset($meta['timed_out']) && $meta['timed_out']) {
echo "请求超时";
}
}
注意：stream_get_meta_data($context) 才能拿到本次请求的元信息，$http_response_header 不可靠，且无法反映底层连接超时。
立即学习“PHP免费学习笔记（深入）”；
HTTPS 请求额外要加 ssl 选项防卡死
很多 HTTPS 地址在没配 ssl 上下文时，file_get_contents 会卡满整个超时时间才返回 false，而不是及时中断。这是因为默认 SSL 配置不完整，握手阶段无法被 timeout 控制。
- 必须在
$opts中补上'ssl' => ['verify_peer' => false, 'verify_peer_name' => false]（开发调试用；生产环境应配 CA 证书） -
verify_peer => false不仅跳过证书校验，也避免 OpenSSL 在验证失败时阻塞 - 若省略
ssl块，即使timeout设为 1 秒，实际可能等 60 秒才返回
超时值设太小会导致误判，设太大失去意义
timeout 是从发起连接开始计时，包含 DNS 查询、TCP 握手、TLS 握手、发送请求、等待响应头全部阶段。它不是“等待响应体的时间”。
- 国内普通 API，建议设
3–8秒；含图片或大文件下载，单独考虑max_redirects和分块读取 - 设
0.5秒几乎必然失败——DNS 解析都可能超时 - 设
30秒以上基本等于没设，PHP 默认default_socket_timeout就是 60，反而掩盖问题 - 线上服务中，应配合
set_time_limit(0)确保脚本不被整体执行时间中断（但超时仍由stream_context控制）
真正难调的是网络抖动场景：有时 2 秒就通，有时 8 秒才响。与其硬设一个值，不如加一层重试 + 指数退避，而超时只是其中一环。
