Proxyautentiseringsalternativ i PHP cURL

Konfigurera proxyuppgifter med rätt cURL-alternativ och hantera URL-avkodningen av det kombinerade fältet utan att ändra destinationsautentisering.

Proxyautentisering har egna cURL-alternativ. CURLOPT_USERPWD för webbplatsinloggning konfigurerar inte proxyns konto, och CURLOPT_HTTPAUTH väljer inte proxyns autentiseringsmetod.

<?php
$user = 'proxy-user';
$password = getenv('PROXY_PASSWORD');
if ($password === false) {
    throw new RuntimeException('Set PROXY_PASSWORD');
}

$ch = curl_init('https://example.com/');
curl_setopt_array($ch, [
    CURLOPT_PROXY => 'http://203.0.113.10:8080',
    CURLOPT_NOPROXY => '',
    CURLOPT_PROXYUSERPWD =>
        rawurlencode($user) . ':' . rawurlencode($password),
    CURLOPT_PROXYAUTH => CURLAUTH_BASIC,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 15,
]);

$body = curl_exec($ch);
if ($body === false) {
    throw new RuntimeException(curl_error($ch), curl_errno($ch));
}
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), PHP_EOL;

Ersätt dokumentations-IP:n och använd uppgifterna som levererats för proxyn. Basic är medvetet valt här; använd metoden tjänsten stöder och godkänner i stället för att anta att alla ändpunkter behöver den.

Det kombinerade fältet har en kodningsregel

libcurl dokumenterar att CURLOPT_PROXYUSERPWD URL-avkodar användarnamn och lösenord. Exemplet kodar varje del innan de förenas med avgränsaren. Det spelar roll om en bokstavlig procentsekvens eller ett annat specialtecken ingår i uppgifterna.

De separata alternativen för proxyanvändarnamn och lösenord tar sina värden direkt:

curl_setopt($ch, CURLOPT_PROXYUSERNAME, $user);
curl_setopt($ch, CURLOPT_PROXYPASSWORD, $password);

Använd dessa som alternativ form före begäran körs. Tillämpa inte automatiskt det kombinerade proxyfältets avkodningsregel på CURLOPT_USERPWD; libcurl dokumenterar en skillnad.

Håll autentiseringsleden åtskilda

CURLOPT_PROXYAUTH väljer proxyautentisering, medan CURLOPT_HTTPAUTH väljer HTTP-autentisering mot destinationen. Kräver båda parter inloggning, konfigurera rätt alternativ för vardera i stället för att kopiera samma uppgifter till båda ställena.

CURLAUTH_ANY tillåter förhandling och kan lägga till en challenge-response-utväxling innan metoden väljs. Det bevisar inte att uppgifterna är rätt. En extra manuellt tillagd Proxy-Authorization-header kan störa bibliotekets autentiseringshantering.

Basic-uppgifter på en klartextanslutning till proxyn skyddas inte av webbplatsens senare TLS-tunnel. Kontrollera den transporten separat när du väljer hur en autentiserad tjänst ska användas.

Relaterade artiklar