PHP Curl错误处理失效，API无响应致脚本冻结求助

原代码 #

<?php

    /* some php code - top */

    /* curl request logic start */

    $ch = curl_init("https://api.abc.com/xyz");
    $response = curl_exec($ch);
    if (curl_errno($ch))
    {
        $error_msg = curl_error($ch);
    }
    curl_close($ch);

    if (isset($error_msg))
    {
        echo 'Curl error: ' . $error_msg;
    }
    else
    {
        echo $response;
    }

    /* curl request logic end */

    /* some php code - bottom */
?>

问题描述 #

当目标API服务器（https://api.abc.com/xyz）关闭或无法访问时，整个PHP脚本执行会冻结。期望即使API不可用，/* some php code - top */和/* some php code - bottom */部分的代码仍能正常执行，页面不会完全挂起。此前尝试的CURL错误处理机制未生效。

解决方案 #

问题根源是CURL默认未设置超时参数，会无限等待服务器响应，导致脚本卡住。只需为CURL添加超时配置，并保留原有错误逻辑即可解决：

1. 添加CURL超时选项 #

通过curl_setopt()设置两个关键超时参数：

• CURLOPT_CONNECTTIMEOUT：限制建立连接的最长时间（单位：秒），建议设为3-5秒
• CURLOPT_TIMEOUT：限制整个CURL请求的最长执行时间（单位：秒），建议设为5-10秒

2. 修改后的完整代码 #

<?php

    /* some php code - top */

    /* curl request logic start */

    $ch = curl_init("https://api.abc.com/xyz");
    // 设置连接超时和总请求超时
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
    curl_setopt($ch, CURLOPT_TIMEOUT, 5);
    // 可选：若需以字符串形式获取响应（而非直接输出），开启以下选项
    // curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $response = curl_exec($ch);
    $error_msg = null;
    if (curl_errno($ch))
    {
        $error_msg = curl_error($ch);
    }
    curl_close($ch);

    if ($error_msg)
    {
        echo 'Curl error: ' . $error_msg;
    }
    else
    {
        echo $response;
    }

    /* curl request logic end */

    /* some php code - bottom */
?>

说明 #

• 设置超时后，即使API服务器不可达，CURL会在指定时间内终止请求，脚本会继续执行后续的/* some php code - bottom */部分
• 开启CURLOPT_RETURNTRANSFER后，$response会存储API的响应内容，方便后续处理（比如解析JSON）而非直接输出

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