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_* 系列 | 並發多請求處理 |
<?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);
?>
<?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);
?>
<?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_CONNECTTIMEOUTCURLOPT_SSL_VERIFYPEER => true,配合 CURLOPT_CAINFO 指定 CA 證書curl_exec() === false 而非 !$responsecurl_multi:批量采集時顯著提升吞吐量cookie.txt 有讀寫權限cURL 是 PHP 網絡編程的瑞士軍刀。掌握 curl_setopt_array 批量配置、CURLOPT_COOKIEJAR/FILE 會話管理、curl_multi 並發處理三大核心技能,即可應對 90% 的 HTTP 交互場景。建議封裝為可復用的 HttpClient 類,統一異常處理、日誌記錄、重試策略。