萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP cURL 庫完整指南:從基礎到實戰的四大經典場景

什麼是 cURL?

cURL (Client URL Library) 是 PHP 中最強大的 HTTP 客端庫,支持 HTTP/HTTPS/FTP 等協議,可模擬瀏覽器請求、處理 Cookie、代理、SSL 驗證等複雜場景。無論是爬蟲、API 對接、還是模擬登錄,cURL 都是首選工具。

核心函數速查表

函數用途
curl_init()初始化會話,返回句柄
curl_setopt()設置單個選項
curl_setopt_array()批量設置選項(推薦)
curl_exec()執行請求,返回響應
curl_getinfo()獲取請求詳情(狀態碼、耗時等)
curl_error() / curl_errno()獲取錯誤信息
curl_close()關閉會話,釋放資源
curl_multi_* 系列並發多請求處理

場景一:基礎 GET 請求

<?php
$ch = curl_init();

// 設置 URL
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/users');

// 返回字符串而非直接輸出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 設置超時(秒)
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

// 執行
$response = curl_exec($ch);

// 錯誤處理
if ($response === false) {
    throw new Exception('cURL Error: ' . curl_error($ch), curl_errno($ch));
}

// 獲取 HTTP 狀態碼
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

curl_close($ch);

// 處理響應
$data = json_decode($response, true);
?>

場景二:POST 表單/JSON 數據提交

<?php
$ch = curl_init('https://api.example.com/orders');

$postData = [
    'product_id' => 123,
    'quantity'   => 2,
    'user_token' => 'abc123'
];

curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query($postData),  // 表單格式
    // CURLOPT_POSTFIELDS => json_encode($postData),         // JSON 格式需加 Header
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/x-www-form-urlencoded',
        // 'Content-Type: application/json',  // JSON 時啟用
    ],
    CURLOPT_TIMEOUT        => 15,
]);

$response = curl_exec($ch);
if ($response === false) {
    // 錯誤處理...
}
curl_close($ch);
?>

場景三:代理服務器請求

<?php
$ch = curl_init('https://httpbin.org/ip');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_PROXY          => 'proxy.example.com:8080',  // 代理地址:端口
    CURLOPT_PROXYUSERPWD   => 'username:password',       // 代理認證(如需)
    CURLOPT_PROXYTYPE      => CURLPROXY_HTTP,            // 或 CURLPROXY_SOCKS5
    CURLOPT_TIMEOUT        => 20,
]);

$response = curl_exec($ch);
// 檢查響應中的 IP 是否為代理 IP
curl_close($ch);
?>

場景四:模擬登錄並保持會話(Cookie 管理)

<?php
// 1. 登錄頁獲取 CSRF Token
$ch = curl_init('https://forum.example.com/login');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_COOKIEJAR      => 'cookie.txt',  // 保存 Cookie 到文件
    CURLOPT_COOKIEFILE     => 'cookie.txt',  // 讀取 Cookie 文件
    CURLOPT_FOLLOWLOCATION => true,          // 跟隨重定向
    CURLOPT_SSL_VERIFYPEER => false,         // 開發環境可關閉 SSL 驗證
]);
$loginPage = curl_exec($ch);

// 解析 formhash(假設為隱藏輸入框)
preg_match('/name="formhash" value="([^"]+)"/', $loginPage, $m);
$formhash = $m[1] ?? '';

curl_close($ch);

// 2. 提交登錄表單
$ch = curl_init('https://forum.example.com/logging.php?action=login');
$postFields = [
    'formhash'    => $formhash,
    'username'    => 'my_user',
    'password'    => 'my_pass',
    'loginsubmit' => 'true',
];

curl_setopt_array($ch, [
    CURLOPT_POST       => true,
    CURLOPT_POSTFIELDS => http_build_query($postFields),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_COOKIEJAR  => 'cookie.txt',
    CURLOPT_COOKIEFILE => 'cookie.txt',
    CURLOPT_REFERER    => 'https://forum.example.com/login',
    CURLOPT_USERAGENT  => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)...',
]);
curl_exec($ch);
curl_close($ch);

// 3. 攜帶 Cookie 訪問受保護頁面
$ch = curl_init('https://forum.example.com/my.php?item=threads');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_COOKIEFILE     => 'cookie.txt',  // 僅讀取,不更新
]);
$protectedPage = curl_exec($ch);
curl_close($ch);

echo $protectedPage;  // 顯示登錄後才可見內容
?>

最佳實踐清單

  • 始終設置超時:CURLOPT_TIMEOUT + CURLOPT_CONNECTTIMEOUT
  • 生產環境驗證 SSL:CURLOPT_SSL_VERIFYPEER => true,配合 CURLOPT_CAINFO 指定 CA 證書
  • 設置 User-Agent:避免被簡單反爬蟲攔截
  • 錯誤處理規範化:檢查 curl_exec() === false 而非 !$response
  • 並發請求用 curl_multi:批量采集時顯著提升吞吐量
  • Cookie 文件權限:確保進程對 cookie.txt 有讀寫權限

總結

cURL 是 PHP 網絡編程的瑞士軍刀。掌握 curl_setopt_array 批量配置、CURLOPT_COOKIEJAR/FILE 會話管理、curl_multi 並發處理三大核心技能,即可應對 90% 的 HTTP 交互場景。建議封裝為可復用的 HttpClient 類,統一異常處理、日誌記錄、重試策略。

copyright © 萬盛學電腦網 all rights reserved