萬盛學電腦網

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

PHP cURL 實現 GET、POST、Cookie 完整提交指南

統一封裝函數

<?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;
}

1. GET 請求(參數自動拼接)

$getData = ['q' => 'php curl', 'page' => 1, 'lang' => 'zh'];
$url = 'https://www.example.com/search?' . http_build_query($getData);
$html = curlRequest($url);

2. POST 表單提交 (application/x-www-form-urlencoded)

$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,兼容性最好、體積最小。

3. POST 文件上傳 (multipart/form-data)

$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);

4. 攜帶 Cookie

方式一:手動拼接 Cookie 字符串

$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);

方式二:Cookie 文件自動管理(推薦,支持會話保持)

$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);

5. 發送 JSON API 請求

$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);

6. 獲取響應頭與調試信息

$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"。
copyright © 萬盛學電腦網 all rights reserved