PHP curl_setopt() 使用教程：輕鬆配置cURL請求選項

M66 2025-10-26

PHP curl_setopt() 函數介紹

cURL是PHP中一個功能強大的擴展，用於發送和接收HTTP請求。在開發過程中，curl_setopt()函數是設置cURL會話選項的關鍵函數，它允許我們靈活配置請求行為和參數。

curl_setopt()語法

curl_setopt()函數的基本語法如下：

 bool curl_setopt(resource $ch, int $option, mixed $value)

參數說明：

$ch：cURL句柄，通過curl_init()函數創建。
$option：要設置的cURL選項。
$value：選項對應的值。

返回值：函數返回布爾值，表示設置是否成功。

curl_setopt()示例

下面是一個使用curl_setopt()發送GET請求並獲取響應的示例：

 // 初始化cURL會話$ch = curl_init();

// 設置要訪問的URL
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/data");

// 設置請求方法為GET
curl_setopt($ch, CURLOPT_HTTPGET, true);

// 設置接收響應內容curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 設置超時時間curl_setopt($ch, CURLOPT_TIMEOUT, 30);

// 執行cURL請求$response = curl_exec($ch);

// 檢查請求是否失敗if ($response === FALSE) {
    echo "請求失敗: " . curl_error($ch);
} else {
    // 處理響應數據echo $response;
}

// 關閉cURL會話curl_close($ch);

示例解析

在示例中，首先通過curl_init()創建cURL句柄($ch)。然後使用curl_setopt()配置請求選項：

CURLOPT_URL：指定請求的URL。
CURLOPT_HTTPGET：將請求方法設置為GET。
CURLOPT_RETURNTRANSFER：設置為true，將響應內容保存到變量而非直接輸出。
CURLOPT_TIMEOUT：設置請求超時時間為30秒。

通過curl_exec()執行請求，如果失敗可以用curl_error()獲取錯誤信息，如果成功則可處理返回的響應內容。最後使用curl_close()關閉cURL會話。

總結

curl_setopt()是PHP cURL擴展中用於配置會話選項的重要函數。通過它，我們可以靈活地設置URL、請求方法、超時等各種選項，實現HTTP請求的發送和響應處理。熟練掌握curl_setopt()能大大提高PHP在網絡請求方面的開發效率和靈活性。