PHP：file_get_contents()的所有可能错误列表及统一处理方法咨询

有没有官方完整错误列表？ #

PHP官方并没有专门整理一份file_get_contents()用于HTTP/SSL下载时的全部错误清单。这类错误大多来自底层依赖：比如PHP的stream扩展、系统网络库（如OpenSSL）、目标服务器返回的HTTP状态码，错误类型会随环境、网络状况、目标服务器配置变化，无法一一枚举。

常见错误分类及处理方向 #

结合你遇到的情况，常见错误可以按类型归类，方便统一处理：

• SSL/TLS连接类错误
  比如你碰到的file_get_contents(): SSL: An existing connection was forcibly closed by the remote host，还有证书不被信任、协议版本不兼容（如仅支持TLS1.0但目标要求TLS1.2）、SSL握手失败等。这类错误部分可重试，部分需要调整SSL配置。
• HTTP请求类错误
  包含目标服务器返回的各类状态码，比如你遇到的file_get_contents(_URL_): Failed to open stream: HTTP request failed! HTTP/1.1 500 Internal Server Error，还有404（资源不存在）、403（权限拒绝）、429（请求频繁）、502/503（服务器临时不可用）等。其中5xx系列多为临时错误，可重试；4xx系列多为永久错误，适合记录后跳过。
• 网络连接类错误
  比如连接超时、主机不可达、连接被重置、DNS解析失败等，这类属于网络层面的临时故障，重试通常有效。

规整化错误处理方案（基于你已转异常的场景） #

既然已经把错误转为异常，建议通过解析异常消息+分类匹配的方式，避免零散的错误判断：

1. 错误消息解析与分类 #

用正则表达式匹配错误中的关键词或HTTP状态码，把异常归类：

function classifyFileGetContentsException(\Exception $e): string {
    $message = $e->getMessage();
    
    // 匹配SSL相关错误
    if (preg_match('/SSL:/i', $message)) {
        return 'ssl_error';
    }
    // 匹配HTTP状态码
    if (preg_match('/HTTP\/1\.\d (\d{3})/', $message, $matches)) {
        $statusCode = $matches[1];
        if ($statusCode >= 500 && $statusCode < 600) {
            return 'http_server_error';
        } elseif ($statusCode >= 400 && $statusCode < 500) {
            return 'http_client_error';
        }
    }
    // 匹配连接重置/失败类错误
    if (preg_match('/Failed to open stream|connection was forcibly closed|timed out/i', $message)) {
        return 'network_error';
    }
    
    return 'unknown_error';
}

2. 统一处理逻辑 #

根据分类结果执行对应操作，比如重试、记录、更新数据库：

$maxRetries = 3;
$currentRetry = 0;
$url = '目标文件URL';

do {
    try {
        $content = file_get_contents($url);
        // 下载成功后的逻辑：保存文件、更新数据库状态等
        break;
    } catch (\Exception $e) {
        $errorType = classifyFileGetContentsException($e);
        $currentRetry++;
        
        switch ($errorType) {
            case 'ssl_error':
                // SSL错误：记录日志，终止重试
                error_log("SSL下载错误：{$e->getMessage()}，URL：{$url}");
                // updateDatabase($url, 'ssl_failed');
                $currentRetry = $maxRetries;
                break;
            case 'http_server_error':
            case 'network_error':
                // 临时错误：等待1秒后重试
                if ($currentRetry <= $maxRetries) {
                    error_log("下载临时错误（{$errorType}），正在重试第{$currentRetry}次：{$e->getMessage()}");
                    sleep(1);
                } else {
                    // 重试耗尽，记录并标记
                    error_log("下载失败（重试耗尽）：{$e->getMessage()}，URL：{$url}");
                    // updateDatabase($url, 'retry_exhausted');
                }
                break;
            case 'http_client_error':
                // 客户端错误：记录后跳过
                error_log("HTTP客户端错误：{$e->getMessage()}，URL：{$url}");
                // updateDatabase($url, 'client_failed');
                $currentRetry = $maxRetries;
                break;
            default:
                // 未知错误：记录后跳过
                error_log("未知下载错误：{$e->getMessage()}，URL：{$url}");
                $currentRetry = $maxRetries;
                break;
        }
    }
} while ($currentRetry <= $maxRetries);

优化建议：改用cURL替代file_get_contents #

file_get_contents()的错误信息比较模糊，而cURL提供了明确的错误码常量（如CURLE_SSL_CONNECT_ERROR、CURLE_OPERATION_TIMEDOUT），更便于精准处理。通过curl_errno()和curl_strerror()可以直接获取标准化的错误类型，无需解析模糊字符串，能大幅提升错误处理的精准度。

内容的提问来源于stack exchange，提问作者Testic