避免在未初始化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之前驗證句柄的有效性，是一項基本但關鍵的防禦式編程實踐。這樣不僅可以防止運行時錯誤，也能提升程序的穩定性與健壯性。

始終記住：不要假設初始化一定成功，安全總比修復更有效。