Параметри автентифікації проксі у 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-тунелем сайту. Вибираючи спосіб використання сервісу з автентифікацією, перевіряйте цей транспорт окремо.

Схожі статті