Параметры аутентификации прокси в PHP cURL

Задавайте данные прокси правильными параметрами cURL и учитывайте URL-декодирование составного поля, не меняя аутентификацию адресата.

Аутентификация прокси имеет собственные параметры cURL. CURLOPT_USERPWD для входа на сайт не задаёт аккаунт прокси, а CURLOPT_HTTPAUTH не выбирает метод аутентификации прокси.

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

Замените адрес для документации и используйте данные, выданные для этого прокси. Basic выбран здесь намеренно; применяйте поддерживаемый и одобренный метод своего сервиса, не считая его нужным каждой точке.

У составного поля есть правило кодирования

libcurl документирует, что CURLOPT_PROXYUSERPWD выполняет URL-декодирование имени и пароля. Пример кодирует каждую часть до соединения разделителем. Это важно, если в данных есть буквальная процентная последовательность или другой специальный символ.

Отдельные параметры имени пользователя и пароля прокси принимают свои значения напрямую:

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

Используйте их как альтернативную форму данных до выполнения запроса. Не переносите автоматически правило декодирования составного поля прокси на CURLOPT_USERPWD: libcurl описывает различие.

Разделяйте участки аутентификации

CURLOPT_PROXYAUTH выбирает аутентификацию прокси, а CURLOPT_HTTPAUTH — HTTP-аутентификацию адресата. Если вход нужен обоим, настройте соответствующие параметры каждого вместо копирования одних данных в оба места.

CURLAUTH_ANY разрешает согласование и может добавить обмен запросом аутентификации и ответом до выбора метода. Это не доказывает правильность данных. Дополнительный ручной заголовок Proxy-Authorization может мешать обработке аутентификации библиотекой.

Basic-данные на незашифрованном соединении с прокси не защищаются последующим TLS-туннелем сайта. При выборе способа использования сервиса с аутентификацией проверяйте этот транспорт отдельно.

Похожие статьи