PHP file_get_contents超时与报错处理方案

前言

file_get_contents 抓取远程接口或网页时经常超时、返回 false 或 SSL 报错，默认没有完善的错误处理，脚本直接中断。它既可以读本地文件也能抓远程 URL，但抓远程推荐配合 context 设超时和错误捕获。本文讲解设置超时、忽略错误、SSL 证书问题、与 cURL 的取舍。

操作步骤

1. 基础读取

$html = file_get_contents('https://example.com/api');

2. 设置超时（流上下文）

$ctx = stream_context_create([
    'http' => [
        'timeout' => 10,
        'method' => 'GET',
    ]
]);
$html = @file_get_contents('https://example.com/api', false, $ctx);

3. 判断失败并报错

if ($html === false) {
    $error = error_get_last();
    echo '请求失败：'.$error['message'];
}

4. 忽略 SSL 证书校验（自签证书）

$ctx = stream_context_create([
    'ssl' => ['verify_peer' => false, 'verify_peer_name' => false]
]);

5. 带请求头与 POST

$ctx = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/json\r\n",
        'content' => json_encode(['a'=>1]),
        'timeout' => 10,
    ]
]);

6. 复杂请求改用 cURL

需要重试、并发、精确状态码时，cURL 更可控。

常见坑

1. 不用 === false 判断，空字符串被当成成功。
2. 没设超时，请求挂起直到 PHP max_execution_time。
3. https 自签证书报 SSL 错误，临时关闭校验仅用于内网。
4. 远端返回 404/500，函数仍返回正文，需自行判断状态。
5. 大文件一次性读入内存，占用过高。
6. allow_url_fopen 被 php.ini 关闭，函数直接失败。
7. 中文 URL 未编码导致请求异常。

总结

file_get_contents 简单抓取够用，必须用 stream_context 设超时、捕获 false 错误、按需处理 SSL。需要状态码、重试、并发就上 cURL。生产环境关闭 SSL 校验只用于可信内网，公网请求保持严格校验。

遇到问题加QQ23979811 协助处理