萬盛學電腦網

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

PHP cURL 實戰精華:模擬登入、SOAP 請求、錯誤處理與安全配置

cURL 基礎初始化模板

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

場景一:模擬表單登入(攜帶 Cookie 會話)

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

場景二:SOAP XML 請求

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

場景三:檔案上傳(multipart/form-data)

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_VERIFYPEERtrue驗證伺服器 SSL 憑證,防止中間人攻擊
CURLOPT_SSL_VERIFYHOST2檢查憑證 CN 與主機名匹配
CURLOPT_CAINFO/path/to/cacert.pem指定 CA 憑證包(如 certifi 提供)
CURLOPT_PROTOCOLSCURLPROTO_HTTPS僅允許 HTTPS,禁止 HTTP/FILE 等協議
CURLOPT_REDIR_PROTOCOLSCURLPROTO_HTTPS重導向也限制 HTTPS
CURLOPT_TIMEOUT30防止掛起耗盡資源
CURLOPT_MAXREDIRS5限制重導向次數防止循環

錯誤處理與除錯技巧

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

非同步並發請求(cURL Multi)

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 介面、中介軟體、非同步支援等企業級功能。

copyright © 萬盛學電腦網 all rights reserved