Proxygodkendelsesindstillinger i PHP cURL

Konfigurer proxyoplysninger med de rigtige cURL-indstillinger og håndter URL-afkodning af det kombinerede felt uden at ændre destinationsgodkendelse.

Proxygodkendelse har egne cURL-indstillinger. CURLOPT_USERPWD til et webstedslogin konfigurerer ikke proxyens konto, og CURLOPT_HTTPAUTH vælger ikke proxyens godkendelsesmetode.

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

Erstat dokumentations-IP’en og brug oplysningerne leveret til proxyen. Basic er valgt bevidst her; brug den metode tjenesten understøtter og godkender i stedet for at antage, at alle endepunkter kræver den.

Det kombinerede felt har en kodningsregel

libcurl dokumenterer, at CURLOPT_PROXYUSERPWD URL-afkoder brugernavn og adgangskode. Eksemplet koder hver del, før de samles med skilletegnet. Det er vigtigt, når en bogstavelig procentsekvens eller et andet specialtegn indgår i oplysningerne.

De separate indstillinger for proxybrugernavn og adgangskode modtager deres respektive værdier direkte:

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

Brug dem som alternativ form før udførelsen af forespørgslen. Anvend ikke automatisk det kombinerede proxyfelts afkodningsregel på CURLOPT_USERPWD; libcurl dokumenterer en forskel.

Hold godkendelsesleddene adskilt

CURLOPT_PROXYAUTH vælger proxygodkendelse, mens CURLOPT_HTTPAUTH vælger HTTP-godkendelse med destinationen. Kræver begge parter login, skal de passende indstillinger angives for hver i stedet for at kopiere samme oplysninger begge steder.

CURLAUTH_ANY tillader forhandling og kan tilføje en udfordrings-/svarudveksling, før en metode vælges. Det beviser ikke, at oplysningerne er korrekte. En ekstra manuelt tilføjet Proxy-Authorization-header kan forstyrre bibliotekets godkendelseshåndtering.

Basic-oplysninger på en klartekstforbindelse til proxyen beskyttes ikke af webstedets senere TLS-tunnel. Kontroller den transport særskilt, når du vælger, hvordan en godkendt tjeneste skal bruges.

Relaterede artikler