function curlRequest(string $url, array $options = []): string|false {
$ch = curl_init($url);
$defaults = [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_TIMEOUT => 30,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_SSL_VERIFYPEER => true, // 生產環境必須驗證憑證
CURLOPT_SSL_VERIFYHOST => 2,
CURLOPT_USERAGENT => 'Mozilla/5.0 (compatible; MyApp/1.0)',
CURLOPT_COOKIEJAR => sys_get_temp_dir() . '/cookie_' . md5($url) . '.txt',
CURLOPT_COOKIEFILE => sys_get_temp_dir() . '/cookie_' . md5($url) . '.txt',
];
curl_setopt_array($ch, $defaults + $options);
$response = curl_exec($ch);
$errno = curl_errno($ch);
$error = curl_error($ch);
$info = curl_getinfo($ch);
curl_close($ch);
if ($errno) {
error_log("cURL Error [$errno]: $error | URL: $url | Info: " . json_encode($info));
return false;
}
return $response;
}
function simulateLogin(string $loginUrl, array $credentials, string $targetUrl): string|false {
$ch = curl_init();
// 1. 登入請求
curl_setopt_array($ch, [
CURLOPT_URL => $loginUrl,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($credentials),
CURLOPT_COOKIEJAR => '/tmp/app_cookies.txt', // 持久化 Cookie
CURLOPT_COOKIEFILE => '/tmp/app_cookies.txt',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_SSL_VERIFYPEER => true,
]);
$loginResult = curl_exec($ch);
if (curl_errno($ch)) {
curl_close($ch);
return false;
}
// 2. 攜帶 Cookie 存取受保護資源
curl_setopt($ch, CURLOPT_URL, $targetUrl);
curl_setopt($ch, CURLOPT_POST, false);
$content = curl_exec($ch);
curl_close($ch);
return $content;
}
// 使用
$html = simulateLogin('https://example.com/login', [
'username' => 'user',
'password' => 'pass',
'csrf_token' => '...' // 先 GET 登入頁解析 CSRF Token
], 'https://example.com/dashboard');
function soapRequest(string $url, string $xmlBody, string $soapAction): string|false {
$ch = curl_init($url);
$headers = [
'Content-Type: text/xml; charset=utf-8',
'Content-Length: ' . strlen($xmlBody),
'SOAPAction: "' . $soapAction . '"',
];
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $xmlBody,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_SSL_VERIFYPEER => true,
]);
$response = curl_exec($ch);
$errno = curl_errno($ch);
curl_close($ch);
if ($errno) return false;
return $response;
}
// SOAP 封裝體範例
$soapXml = <<
12345
XML;
$response = soapRequest('https://api.example.com/soap', $soapXml, 'https://example.com/api/GetUser');
function uploadFile(string $url, string $filePath, string $fieldName = 'file'): string|false {
if (!file_exists($filePath)) return false;
$cfile = new CURLFile($filePath, mime_content_type($filePath), basename($filePath));
$postData = [$fieldName => $cfile];
return curlRequest($url, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $postData,
]);
}
| 選項 | 建議值 | 說明 |
|---|---|---|
| CURLOPT_SSL_VERIFYPEER | true | 驗證伺服器 SSL 憑證,防止中間人攻擊 |
| CURLOPT_SSL_VERIFYHOST | 2 | 檢查憑證 CN 與主機名匹配 |
| CURLOPT_CAINFO | /path/to/cacert.pem | 指定 CA 憑證包(如 certifi 提供) |
| CURLOPT_PROTOCOLS | CURLPROTO_HTTPS | 僅允許 HTTPS,禁止 HTTP/FILE 等協議 |
| CURLOPT_REDIR_PROTOCOLS | CURLPROTO_HTTPS | 重導向也限制 HTTPS |
| CURLOPT_TIMEOUT | 30 | 防止掛起耗盡資源 |
| CURLOPT_MAXREDIRS | 5 | 限制重導向次數防止循環 |
$response = curlRequest($url, [
CURLOPT_VERBOSE => true, // 輸出詳細通訊日誌
CURLOPT_STDERR => fopen('/tmp/curl_debug.log', 'w'), // 導向檔案
]);
// 取得 HTTP 狀態碼
$info = curl_getinfo($ch);
$httpCode = $info['http_code'] ?? 0;
if ($httpCode >= 400) {
throw new HttpException("HTTP $httpCode", $httpCode);
}
function curlMultiRequest(array $urls): array {
$mh = curl_multi_init();
$handles = [];
foreach ($urls as $i => $url) {
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
]);
curl_multi_add_handle($mh, $ch);
$handles[$i] = $ch;
}
$running = null;
do {
curl_multi_exec($mh, $running);
curl_multi_select($mh, 0.5); // 等待活動
} while ($running > 0);
$results = [];
foreach ($handles as $i => $ch) {
$results[$i] = [
'content' => curl_multi_getcontent($ch),
'error' => curl_error($ch),
'info' => curl_getinfo($ch),
];
curl_multi_remove_handle($mh, $ch);
curl_close($ch);
}
curl_multi_close($mh);
return $results;
}
掌握 cURL 核心選項、安全配置、錯誤處理與多工模式,能構建健壯的 HTTP 客戶端。現代專案亦可考慮 Guzzle、Symfony HttpClient 等高層封裝,提供 PSR-18 介面、中介軟體、非同步支援等企業級功能。