用curl_init 下載文件並保存到本地的完整方法，超實用示例

gitbox 2025-06-15

在PHP 中， curl是一個非常強大且常用的工具，能夠處理各種HTTP 請求。使用curl_init()函數，我們可以輕鬆地下載文件並將其保存到本地。今天我們將詳細介紹如何使用curl_init來下載文件，並給出一個超實用的示例，幫助你更好地理解這一過程。

步驟1：初始化cURL 會話

首先，我們需要使用curl_init()來初始化一個cURL 會話，它會返回一個cURL 句柄。這個句柄用於後續的cURL 操作。

 $ch = curl_init();

步驟2：設置cURL 選項

在成功初始化會話後，我們需要使用curl_setopt()來設置各類選項。最關鍵的幾個選項包括：

CURLOPT_URL : 設置下載文件的URL 地址。
CURLOPT_RETURNTRANSFER : 設定返回值的方式。我們希望將文件內容保存到本地，因此需要將其設置為true 。
CURLOPT_FOLLOWLOCATION : 允許cURL 自動跟隨重定向。
CURLOPT_TIMEOUT : 設置最大執行時間，避免請求掛起。

假設我們要下載的文件URL 為https://gitbox.net/somefile.zip ，以下是設置這些選項的示例：

 $url = "https://gitbox.net/somefile.zip";
$destination = "somefile.zip";  // 本地保存路徑

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);  // 設置請求超時為 30 秒

步驟3：執行cURL 請求並獲取文件內容

設置好cURL 選項後，我們可以使用curl_exec()執行請求。該函數會返回服務器的響應內容，也就是文件的內容。我們將這個內容保存到本地文件中。

 $file_content = curl_exec($ch);

if(curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    // 將下載的文件內容保存到本地
    file_put_contents($destination, $file_content);
}

步驟4：關閉cURL 會話

操作完成後，我們應當使用curl_close()關閉當前的cURL 會話，釋放資源。

 curl_close($ch);

完整代碼示例

將上述各個步驟整合在一起，我們得到以下完整的PHP 腳本，用於通過cURL 下載文件並保存到本地。

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

// 設置下載文件的 URL 和本地保存路徑
$url = "https://gitbox.net/somefile.zip";
$destination = "somefile.zip";

// 配置 cURL 選項
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);  // 請求超時 30 秒

// 執行 cURL 請求並獲取文件內容
$file_content = curl_exec($ch);

// 錯誤處理
if(curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    // 保存文件到本地
    file_put_contents($destination, $file_content);
}

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

echo "文件下載成功，已保存至 " . $destination;
?>

代碼解讀

初始化和配置：我們首先使用curl_init()初始化一個cURL 會話，並設置下載URL 和保存路徑。 curl_setopt()設置了多個重要選項，包括文件URL、返回內容的處理方式以及是否允許重定向。
執行請求：使用curl_exec()執行請求並獲取文件內容。如果下載成功，文件內容會被保存到$file_content變量中。
錯誤處理：如果cURL 請求發生錯誤，我們可以通過curl_errno()獲取錯誤信息，並通過curl_error()輸出錯誤詳情。
保存文件：通過file_put_contents()將下載的文件內容保存到本地指定的路徑。
關閉會話：最後，我們使用curl_close()來關閉cURL 會話。

小結

以上就是使用curl_init()下載文件並保存到本地的完整方法。無論是簡單的文件下載還是處理複雜的HTTP 請求， curl都是一個非常實用的工具。通過調整cURL 的選項，你可以實現更複雜的需求，如模擬登錄、發送POST 請求、處理cookies 等等。

希望這個示例對你有所幫助，祝你在PHP 編程中越做越好！