DIV CSS 佈局教程網

PHP cURL 五個經典應用範例與常用設定選項
編輯:關於JavaScript     

一、基本請求流程

四個步驟:初始化、設定選項、執行並取得內容、釋放句柄。

<?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_getinfo() 除錯

這個函式回傳請求的詳細資訊,對排查問題很有幫助:

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 "下載資料完整";
}
?>

四、以 POST 送出資料

<?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 標頭自動重導時,自動帶上 Referer
  • CURLOPT_FOLLOWLOCATION — 自動跟隨 302 重導(本範例未開啟,實務上很常用)
  • CURLOPT_COOKIESESSION — 只傳 session cookie,忽略其他 cookie
  • CURLOPT_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,學一次到處可用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved