四個步驟:初始化、設定選項、執行並取得內容、釋放句柄。
<?php $ch = curl_init(); // 1. 初始化 curl_setopt($ch, CURLOPT_URL, "https://www.cnblogs.com/"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // 以字串回傳而非直接輸出 curl_setopt($ch, CURLOPT_HEADER, 1); // 將回應標頭併入輸出 curl_exec($ch); // 2. 執行 curl_close($ch); // 3. 釋放 ?>
第二步是整個流程的關鍵,也就是 curl_setopt()。實務上應補上錯誤檢查,注意這裡用 === 而非 ==,才能區分「空字串輸出」與「執行失敗回傳 false」:
$output = curl_exec($ch);
if ($output === false) {
echo "cURL Error: " . curl_error($ch);
}
這個函式回傳請求的詳細資訊,對排查問題很有幫助:
curl_exec($ch); $info = curl_getinfo($ch); echo '<pre>'; print_r($info); echo '</pre>';
回傳的陣列包含 url、content_type、http_code、header_size、total_time、namelookup_time、connect_time、size_download、speed_download、redirect_url 等欄位。
實務技巧:抓取資料時常因網路因素導致內容不完整。此時可將實際寫入檔案後的 filesize() 與 $info['size_download'] 比對,若兩者相等即認定下載完整,否則重試。
<?php
header("Content-Type: image/png");
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://example.com/image.png");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 1);
$res = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);
file_put_contents("d:/aa.png", $res);
$size = filesize("d:/aa.png");
if ($size != $info['size_download']) {
echo "下載的資料不完整,請重新下載";
} else {
echo "下載資料完整";
}
?>
<?php
$ch = curl_init();
$data = array('name' => 'kelly', 'age' => 27, 'sex' => 1);
curl_setopt($ch, CURLOPT_URL, "https://localhost/post.php");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1); // 設為 POST
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // 帶入要送出的欄位
$res = curl_exec($ch);
curl_close($ch);
echo $res;
?>
同樣的思路可用於模擬表單送出、批次登入等情境。
<?php
$data = array('name' => 'beauty', "upload" => "@a.zip"); // 檔名前加 @ 並使用完整路徑
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://127.0.0.1/upload_file.php");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$res = curl_exec($ch);
curl_close($ch);
echo $res;
?>
關鍵是檔名前的 @ 前綴與絕對路徑。要注意的是,PHP 5.6 起 @ 這種寫法已不建議使用,5.5 更發出 deprecated 警告,改用 CURLFile 類別才是正確做法:
$data = array(
'name' => 'beauty',
'upload' => new CURLFile('/absolute/path/a.zip')
);
cURL 的能力幾乎都在這些選項裡,以下幾個最常派上用場:
CURLOPT_AUTOREFERER — 依 Location 標頭自動重導時,自動帶上 RefererCURLOPT_FOLLOWLOCATION — 自動跟隨 302 重導(本範例未開啟,實務上很常用)CURLOPT_COOKIESESSION — 只傳 session cookie,忽略其他 cookieCURLOPT_COOKIE — 設定請求中 cookie 的內容,多個以「; 」分隔CURLOPT_HEADER — 將回應標頭作為資料流一併輸出CURLOPT_INFILESIZE — 告知上傳檔案大小,單位為位元組CURLOPT_MAXCONNECTS — 允許的最大連線數CURLOPT_MAXREDIRS — 允許的最大重導次數CURLOPT_TIMEOUT / CURLOPT_CONNECTTIMEOUT — 總逾時與連線逾時,正式環境一定要設CURLOPT_SSL_VERIFYPEER / CURLOPT_SSL_VERIFYHOST — HTTPS 憑證驗證,除測試環境外不應關閉完整清單請參考 PHP 官方手冊。cURL 是通用函式庫而非 PHP 專屬,在其他語言中也有對應的 binding,學一次到處可用。