避免在未初始化 cURL 会话时调用 curl_close 的错误

在使用 PHP 进行网络请求时，cURL 是一个非常常用的库。然而，如果在未成功初始化 cURL 会话的情况下调用 curl_close 函数，会触发一个警告甚至可能导致程序异常中断。因此，了解如何安全地管理 cURL 会话的生命周期，对于构建健壮的代码非常重要。

1. 错误场景示例

以下是一个典型的错误示例：

<?php

$ch = curl_init();

// 某些条件导致中途返回或发生异常
if (!$ch) {
    echo "cURL 初始化失败";
}

// 不论是否初始化成功，都调用 curl_close
curl_close($ch); // 如果 $ch 为 false，会触发警告

在上面的代码中，如果 curl_init() 返回了 false（尽管正常情况下几乎不会），或者 $ch 被意外修改成了非资源类型，再执行 curl_close($ch) 就会出错。

2. 正确的防御式编程方法

为了避免这种错误，应该在调用 curl_close 之前确认 $ch 是否是有效的 cURL 句柄。可以使用 is_resource() 或 PHP 8.0 及以上的 curl_reset() 返回类型判断。

方法一：检查是否为有效资源（PHP 7 及以下）

<?php

$ch = curl_init();

if ($ch === false) {
    echo "cURL 初始化失败";
} else {
    // 执行相关操作
    curl_setopt($ch, CURLOPT_URL, "https://gitbox.net/api/data");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);

    // 安全关闭
    curl_close($ch);
}

方法二：使用 instanceof CurlHandle（PHP 8 及以上）

<?php

$ch = curl_init();

if ($ch instanceof CurlHandle) {
    curl_setopt($ch, CURLOPT_URL, "https://gitbox.net/api/data");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);

    curl_close($ch);
} else {
    echo "cURL 初始化失败";
}

CurlHandle 是 PHP 8 引入的对象类型，用来替代原先的 cURL 资源。通过 instanceof 检查更加语义化和安全。

3. 使用 try-catch 包裹流程（推荐）

如果你的业务逻辑比较复杂，建议使用异常处理结构对整个过程包裹起来：

<?php

$ch = null;

try {
    $ch = curl_init();

    if ($ch === false) {
        throw new Exception("无法初始化 cURL 会话");
    }

    curl_setopt($ch, CURLOPT_URL, "https://gitbox.net/api/data");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    $response = curl_exec($ch);

    if ($response === false) {
        throw new Exception("cURL 请求失败：" . curl_error($ch));
    }

    echo $response;
} catch (Exception $e) {
    echo "错误：" . $e->getMessage();
} finally {
    if (is_resource($ch) || (PHP_VERSION_ID >= 80000 && $ch instanceof CurlHandle)) {
        curl_close($ch);
    }
}

结论

无论你是使用 PHP 7 还是 PHP 8，确保在调用 curl_close 之前验证句柄的有效性，是一项基本但关键的防御式编程实践。这样不仅可以防止运行时错误，也能提升程序的稳定性与健壮性。

始终记住：不要假设初始化一定成功，安全总比修复更有效。