Proxy-todennuksen asetukset PHP cURLissa

Määritä proxytunnukset oikeilla cURL-asetuksilla ja huomioi yhdistelmäkentän URL-dekoodaus muuttamatta kohteen todennusta.

Proxy-todennuksella on omat cURL-asetuksensa. Sivustokirjautumisen CURLOPT_USERPWD ei määritä välityspalvelimen tiliä, eikä CURLOPT_HTTPAUTH valitse proxyn todennusmenetelmää.

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

Korvaa dokumentaatio-IP ja käytä kyseiselle proxylle annettuja tunnuksia. Basic on valittu tarkoituksella esimerkissä; käytä palvelun tukemaa ja hyväksymää menetelmää äläkä oleta jokaisen päätepisteen tarvitsevan sitä.

Yhdistelmäkentällä on koodaussääntö

libcurl dokumentoi, että CURLOPT_PROXYUSERPWD URL-dekoodaa käyttäjänimen ja salasanan. Esimerkki koodaa kummankin osan ennen niiden yhdistämistä erottimella. Tämä merkitsee, jos tunnuksissa on kirjaimellinen prosenttijono tai muu erikoismerkki.

Erilliset proxykäyttäjänimen ja salasanan asetukset hyväksyvät arvonsa suoraan:

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

Käytä niitä vaihtoehtoisena tunnusmuotona ennen pyynnön suoritusta. Älä sovella yhdistetyn proxykentän dekoodaussääntöä automaattisesti CURLOPT_USERPWD:hen; libcurl dokumentoi eron.

Pidä todennusvälit erillään

CURLOPT_PROXYAUTH valitsee proxy-todennuksen, CURLOPT_HTTPAUTH puolestaan kohteen HTTP-todennuksen. Jos molemmat vaativat kirjautumisen, määritä kummallekin oikeat asetukset äläkä kopioi samoja tunnuksia molempiin paikkoihin.

CURLAUTH_ANY sallii neuvottelun ja voi lisätä haaste-vastausvaihdon ennen menetelmän valintaa. Se ei todista tunnuksia oikeiksi. Käsin lisätty Proxy-Authorization-otsake voi lisäksi häiritä kirjaston todennuskäsittelyä.

Basic-tunnuksia selväkielisellä yhteydellä proxyyn ei suojaa sivuston myöhempi TLS-tunneli. Tarkista tämä siirtotapa erikseen valitessasi todennetun palvelun käyttöä.

Aiheeseen liittyvät artikkelit