PHP使用file_get_contents请求HTTPS接口无法获取正确错误响应如何解决

• 原生file_get_contents默认配置下，遇到HTTP 4xx/5xx错误状态码时会直接返回false，同时抛出警告，不会读取接口返回的响应体，因此无法拿到规范的JSON错误信息。
• 你提供的初始代码存在逻辑错误：直接对URL字符串执行json_decode，没有实际发起HTTP请求读取返回内容。
• HTTPS请求不需要单独提供证书，只要PHP环境配置了公共CA根证书即可正常发起验证，大部分正式运行环境默认已配置该项。

方案1：调整file_get_contents上下文配置 #

通过修改请求上下文的ignore_errors参数，强制读取错误状态下的响应内容，代码示例如下：

// 配置请求上下文
$context = stream_context_create([
    'http' => [
        'ignore_errors' => true, // 遇到4xx/5xx错误仍然读取响应内容
        'timeout' => 10
    ],
    'ssl' => [
        'verify_peer' => true,
        'verify_peer_name' => true
    ]
]);

$apiKey = '替换为你的实际API Key';
$address = '3891 Delwood Drive, Powell, OH, United States';
$requestUrl = "https://geocode.search.hereapi.com/v1/geocode?apiKey={$apiKey}&q=" . urlencode($address);

// 发起请求读取返回内容
$response = file_get_contents($requestUrl, false, $context);
$responseData = json_decode($response, true);

// 读取响应状态码做分支处理
$statusCode = explode(' ', $http_response_header[0])[1];
if ($statusCode == 200) {
    // 正常处理地理编码结果
    var_dump($responseData);
} else {
    // 读取接口返回的规范错误信息
    echo "错误类型：" . $responseData['error'] . PHP_EOL;
    echo "错误描述：" . $responseData['error_description'] . PHP_EOL;
}

方案2：使用cURL发起请求（更推荐） #

cURL的可控性更强，默认支持读取错误状态下的响应内容，适配性更好，代码示例如下：

$apiKey = '替换为你的实际API Key';
$address = '3891 Delwood Drive, Powell, OH, United States';
$url = "https://geocode.search.hereapi.com/v1/geocode?apiKey={$apiKey}&q=" . urlencode($address);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    // 处理网络层、请求层错误
    $requestError = curl_error($ch);
    var_dump($requestError);
} else {
    $responseData = json_decode($response, true);
    if ($statusCode == 200) {
        // 正常处理地理编码结果
        var_dump($responseData);
    } else {
        // 读取接口返回的规范错误信息
        echo "错误类型：" . $responseData['error'] . PHP_EOL;
        echo "错误描述：" . $responseData['error_description'] . PHP_EOL;
    }
}

curl_close($ch);

额外说明 #

如果你的PHP环境出现HTTPS证书验证失败的问题，只需要下载官方公共CA根证书包，在php.ini中配置curl.cainfo和openssl.cafile的路径为证书文件的本地路径即可，不需要每次请求单独携带证书。

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