<?php
function curlRequest(string $url, array $options = []): ?string {
$defaults = [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_MAXREDIRS => 5,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_USERAGENT => 'Mozilla/5.0 (compatible; MyBot/1.0)',
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
];
$ch = curl_init();
curl_setopt_array($ch, $defaults + $options);
$response = curl_exec($ch);
if ($response === false) {
error_log("cURL error: " . curl_error($ch));
}
curl_close($ch);
return $response;
}
$getData = ['q' => 'php curl', 'page' => 1, 'lang' => 'zh'];
$url = 'https://www.example.com/search?' . http_build_query($getData);
$html = curlRequest($url);
$postData = ['username' => 'admin', 'password' => 'secret', 'remember' => 1];
$options = [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($postData), // 關鍵:編碼為 key=val&key2=val2
];
$html = curlRequest('https://www.example.com/login', $options);
為什麼用 http_build_query? 直接傳陣列會發送 multipart/form-data(含 boundary),部分老舊服務器不支持;http_build_query 生成標準 application/x-www-form-urlencoded,兼容性最好、體積最小。
$postData = [
'file' => new CURLFile('/path/to/image.jpg', 'image/jpeg', 'avatar.jpg'), // PHP 5.5+
'user_id' => 123,
];
$options = [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $postData, // 陣列含 CURLFile 自動變 multipart
];
$html = curlRequest('https://www.example.com/upload', $options);
$cookies = ['session_id' => 'abc123', 'csrf_token' => 'xyz789'];
$cookieStr = implode('; ', array_map(fn($k, $v) => "$k=$v", array_keys($cookies), $cookies));
$options = [CURLOPT_COOKIE => $cookieStr];
$html = curlRequest('https://www.example.com/profile', $options);
$cookieFile = sys_get_temp_dir() . '/cookies_' . md5($url) . '.txt';
$options = [
CURLOPT_COOKIEJAR => $cookieFile, // 響應 Cookie 寫入文件
CURLOPT_COOKIEFILE => $cookieFile, // 請求時讀取文件發送 Cookie
];
$html = curlRequest('https://www.example.com/login', $options + [CURLOPT_POST=>true, CURLOPT_POSTFIELDS=>$loginData]);
// 後續請求自動攜帶登錄後的 Cookie
$html = curlRequest('https://www.example.com/dashboard', $options);
$json = json_encode(['action' => 'create', 'data' => [...]], JSON_UNESCAPED_UNICODE);
$options = [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => $json,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Content-Length: ' . strlen($json),
],
];
$resp = curlRequest('https://api.example.com/endpoint', $options);
$ch = curl_init($url);
curl_setopt_array($ch, $defaults + $options);
curl_setopt($ch, CURLOPT_HEADER, true); // 響應頭包含在返回字符串中
$response = curl_exec($ch);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$headers = substr($response, 0, $headerSize);
$body = substr($response, $headerSize);
// 解析 headers
$headerArr = [];
foreach (explode("\r\n", $headers) as $line) {
if (strpos($line, ':') !== false) {
[$k, $v] = explode(':', $line, 2);
$headerArr[trim($k)] = trim($v);
}
}
curl_close($ch);
CURLOPT_VERBOSE => true + CURLOPT_STDERR => fopen('php://temp', 'rw') 獲取詳細通訊日誌。curl -v "URL" -H "Header: val" -d "post=data"。