К содержимому

PHP cURL и Guzzle через прокси: настройка и ошибки

Опции прокси в PHP cURL и Guzzle, безопасные тайм-ауты и способ понять, откуда ошибка: от прокси или от целевого сайта.

Один и тот же прокси в cURL и в Guzzle

Один и тот же прокси в cURL и в Guzzle
ПунктPHP cURLGuzzle
Адрес и протокол проксиCURLOPT_PROXY со схемой: http://HOST:2222 или socks5h://HOST:3333'proxy' => та же строка; она копируется в CURLOPT_PROXY
Логин и парольCURLOPT_PROXYUSERPWD => 'USERNAME:PASSWORD'В URL прокси или в 'curl' => [CURLOPT_PROXYUSERPWD => ...]
Тайм-аут подключенияCURLOPT_CONNECTTIMEOUT, по умолчанию 300 секунд'connect_timeout', по умолчанию 0 — ждать бесконечно
Общий тайм-аутCURLOPT_TIMEOUT, по умолчанию 0 — без ограничения'timeout', по умолчанию 0 — ждать бесконечно

Источник: константы cURL в руководстве PHP, страница libcurl CURLOPT_PROXY и Request options Guzzle, прочитаны 17 ноября 2026. Страница Guzzle не упоминает SOCKS5; при обработчике cURL строка передаётся прямо в libcurl.

PHP cURL: прокси, тайм-ауты и коды ошибок

В примере прокси задан со схемой, логин передан через CURLOPT_PROXYUSERPWD, оба тайм-аута установлены. Когда логин передаётся отдельно, спецсимволы в пароле кодировать не нужно; на странице libcurl, которую мы читали, не сказано, декодируются ли логин и пароль внутри строки прокси. Используйте socks5h://, если имя целевого сайта должен разрешать прокси.

После curl_exec() прочитайте три значения: curl_errno() (0 — ошибки cURL нет), CURLINFO_HTTP_CODE (ответ целевого сайта) и CURLINFO_HTTP_CONNECTCODE (ответ прокси на CONNECT). Вместе они показывают, виноват прокси или сайт.

Пример PHP cURL с классификацией ошибок

<?php
// PHP cURL extension. Save as check.php and run: php check.php

function fetchViaProxy(string $url, string $proxy, string $userpwd): array
{
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_PROXY          => $proxy,     // 'http://HOST:2222' or 'socks5h://HOST:3333'
        CURLOPT_PROXYUSERPWD   => $userpwd,   // 'USERNAME:PASSWORD'
        CURLOPT_CONNECTTIMEOUT => 10,         // PHP default is 300 seconds
        CURLOPT_TIMEOUT        => 30,         // PHP default is 0 = no limit
    ]);
    $body = curl_exec($ch);

    return [
        'body'        => $body,
        'errno'       => curl_errno($ch),                           // 0 = no cURL error
        'error'       => curl_error($ch),
        'http'        => curl_getinfo($ch, CURLINFO_HTTP_CODE),     // answer of the target site
        'connectCode' => curl_getinfo($ch, CURLINFO_HTTP_CONNECTCODE), // answer of the proxy to CONNECT
        'seconds'     => curl_getinfo($ch, CURLINFO_TOTAL_TIME),
    ];
}

function explain(array $r): string
{
    switch ($r['errno']) {
        case 0:   return $r['http'] >= 400 ? "target answered HTTP {$r['http']}" : 'ok';
        case 5:   return 'proxy host name cannot be resolved: check HOST';
        case 7:   return 'cannot open a connection to the proxy or the target: check HOST, PORT, firewall';
        case 28:  return 'timeout: proxy or target too slow, or wrong port';
        case 35:  return 'TLS handshake failed';
        case 52:
        case 56:  return 'connection closed or nothing received: check the protocol matches the port';
        case 97:  return 'proxy handshake failed (SOCKS): check protocol, username and password';
        default:  return "cURL error {$r['errno']}: {$r['error']}";
    }
}

$r = fetchViaProxy('https://ipinfo.io/json', 'http://HOST:2222', 'USERNAME:PASSWORD');
echo explain($r), PHP_EOL;
if ($r['connectCode'] === 407) {
    echo 'The proxy answered CONNECT with 407: check username, password and the IP term', PHP_EOL;
}
echo $r['body'], PHP_EOL;

Подставьте HOST, USERNAME и PASSWORD из «Мои активы», порт должен соответствовать протоколу. Тексты ошибок соответствуют странице кодов libcurl.

Что номера ошибок cURL говорят о прокси

Что номера ошибок cURL говорят о прокси
ПунктЗначение в libcurlЧто проверить сначала
5Не удалось разрешить хост проксиПравильность HOST, DNS машины
7Не удалось соединиться с целью или проксиHOST и PORT, брандмауэр, соответствие протокола порту
28Истекло время ожиданияПорт, медленный сайт или слишком короткий тайм-аут
35Сбой TLS-рукопожатияСертификат сайта или ПО на машине, перехватывающее HTTPS
52, 55, 56Ничего не получено, сбой отправки, сбой приёмаСхема в CURLOPT_PROXY должна совпадать с портом: http для 2222, socks5h для 3333
97Не удалось рукопожатие с проксиПротокол, логин, пароль; в PHP 8.2 и новее подробности даёт CURLINFO_PROXY_ERROR

Источник: страница кодов ошибок libcurl и константы руководства PHP, прочитаны 17 ноября 2026. Столбец «Что проверить» — наше прочтение этих описаний.

Guzzle: опция proxy и два класса исключений

Документированная опция proxy в Guzzle принимает строку для всех протоколов или массив с http, https и списком no. NO_PROXY из окружения подставляется, только если вы не передали собственную опцию proxy. SOCKS5 в документации не упомянут, но в исходном коде строка копируется в CURLOPT_PROXY, так что с обработчиком cURL адрес socks5h:// передаётся в libcurl как есть.

Что касается ошибок, в исходном коде Guzzle ConnectException создаётся только для ошибок cURL 28, 6, 7, 35 и 52. Всё остальное, например 5 (хост прокси), 56 (приём) и 97 (рукопожатие с прокси), приходит как RequestException без ответа. Ответ 4xx или 5xx от сайта — тоже RequestException (ClientException или ServerException), если не установить http_errors в false.

Пример Guzzle с обоими классами исключений

<?php
// composer require guzzlehttp/guzzle
// Load Composer's autoload.php here (require the file Composer created in your project).

use GuzzleHttp\Client;
use GuzzleHttp\Exception\ConnectException;
use GuzzleHttp\Exception\RequestException;

$client = new Client([
    'proxy'           => 'http://HOST:2222',       // or 'socks5h://HOST:3333' for an IP bought as SOCKS5
    'curl'            => [CURLOPT_PROXYUSERPWD => 'USERNAME:PASSWORD'],
    'connect_timeout' => 10,                        // Guzzle default is 0 = wait indefinitely
    'timeout'         => 30,                        // Guzzle default is 0 = wait indefinitely
]);

try {
    $response = $client->request('GET', 'https://ipinfo.io/json');
    echo $response->getBody(), PHP_EOL;
} catch (ConnectException $e) {
    // Guzzle's cURL handler uses this class for errno 6, 7, 28, 35 and 52
    $errno = $e->getHandlerContext()['errno'] ?? '?';
    echo "Connection problem (errno $errno): ", $e->getMessage(), PHP_EOL;
} catch (RequestException $e) {
    if ($e->hasResponse()) {
        echo 'HTTP ', $e->getResponse()->getStatusCode(), PHP_EOL;     // 4xx or 5xx from the target
    } else {
        // other cURL errors, for example 5 (proxy host), 56 (receive) or 97 (proxy handshake)
        $errno = $e->getHandlerContext()['errno'] ?? '?';
        echo "No response (errno $errno): ", $e->getMessage(), PHP_EOL;
    }
}

Подставьте HOST, USERNAME и PASSWORD из «Мои активы». Комментарии про номера errno соответствуют исходному коду Guzzle 7.9.

Быстрые исправления

Скрипт зависает на минуты

Проверьте Заданы ли оба тайм-аута? В PHP тайм-аут подключения по умолчанию 300 секунд, общий 0, а оба значения по умолчанию в Guzzle ждут бесконечно.

Решение Задайте CURLOPT_CONNECTTIMEOUT и CURLOPT_TIMEOUT или connect_timeout и timeout.

errno 7 или 56 сразу после подключения

Проверьте Совпадает ли схема с портом? IP, купленный как HTTP, отвечает на 2222, купленный как SOCKS5 — на 3333.

Решение Заново скопируйте HOST, PORT и протокол из «Мои активы» и запустите curl -x с теми же значениями.

connectCode 407 или errno 97

Проверьте Логин, пароль и дата окончания IP.

Решение Заново скопируйте данные и проверьте их через curl. Про ответ 407 читайте в руководстве по авторизации на прокси.

Когда остановиться Если curl с теми же данными тоже не работает, проблема в данных прокси, а не в PHP.

HTTP 403 или 429 и errno 0

Проверьте Прокси работает: ошибки cURL нет, ответ пришёл от целевого сайта.

Решение Прочитайте правила сайта и снизьте частоту запросов. Это не неисправность прокси.

Как это сделать с Proxy302

  1. Шаг 1

    Выберите продукт на странице автоматизации. IP дата-центра стоит $0,25 за 1 день или $3,99 за 30 дней, одинаково во всех странах; ротационные резидентные оплачиваются за ГБ. Бесплатного пробного периода нет.

  2. Шаг 2

    Откройте «Мои активы» и скопируйте HOST, PORT, USERNAME и PASSWORD. У арендованного IP один протокол, выбранный при покупке: HTTP на порту 2222 или SOCKS5 на порту 3333.

  3. Шаг 3

    Запустите пример с cURL, затем с Guzzle. Прочитайте ответ ipinfo.io: IP и страна должны быть прокси.

    Ожидаемый результат JSON с IP прокси и без текста ошибки.

Частые вопросы

Как задать прокси с логином и паролем в PHP cURL?

Задайте CURLOPT_PROXY как адрес со схемой, а CURLOPT_PROXYUSERPWD как USERNAME:PASSWORD, как описано в руководстве PHP.

Поддерживает ли Guzzle прокси SOCKS5?

В документации об этом не сказано. В исходном коде строка прокси копируется в CURLOPT_PROXY, а libcurl принимает socks5:// и socks5h://, так что с обработчиком cURL это работает как строка. Подтвердите запросом к ipinfo.io.

Как отличить ошибку прокси от ошибки сайта?

Если curl_errno() не равен 0, запрос не завершился: 5, 7 и 97 указывают на прокси, 28 — тайм-аут. Если он равен 0, а CURLINFO_HTTP_CODE — 4xx или 5xx, прокси работает, а сайт ответил этим кодом.

Почему скрипт так долго ждёт, если прокси недоступен?

Тайм-аут подключения в PHP по умолчанию 300 секунд, общий — 0 (без ограничения), а значения Guzzle по умолчанию ждут бесконечно. Задайте оба тайм-аута.

Можно ли бесплатно попробовать Proxy302 из PHP?

Бесплатного пробного периода нет. Минимальные покупки — 1 ГБ ротационного резидентного трафика или один IP на один день.

Ссылки и источники

8
  1. libcurl: CURLOPT_PROXY

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: допустимые схемы http://, https://, socks4://, socks4a://, socks5:// и socks5h:// (socks5h — имя хоста разрешает прокси); без порта используется 1080; логин и пароль можно писать в строке или задавать через CURLOPT_PROXYUSERNAME и CURLOPT_PROXYPASSWORD; опция приоритетнее переменных окружения прокси; пустая строка отключает прокси.

    Страница не говорит, нужно ли кодировать логин и пароль в строке.

  2. libcurl: коды ошибок

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: 5 — не удалось разрешить хост прокси, 6 — не удалось разрешить хост цели, 7 — не удалось установить соединение с целью или прокси, 28 — истекло время, 35 — сбой TLS-рукопожатия, 52 — ничего не получено, 55 — сбой отправки, 56 — сбой приёма, 97 — сбой рукопожатия с прокси (подробности в CURLINFO_PROXY_ERROR).

  3. Руководство PHP: константы cURL

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: CURLOPT_PROXY, CURLOPT_PROXYUSERPWD ([username]:[password]), CURLOPT_PROXYTYPE (по умолчанию CURLPROXY_HTTP), CURLOPT_CONNECTTIMEOUT (по умолчанию 300 секунд, 0 — ждать бесконечно), CURLOPT_TIMEOUT (по умолчанию 0, время передачи не ограничено), CURLINFO_HTTP_CONNECTCODE (код ответа на CONNECT), CURLINFO_PROXY_ERROR (с PHP 8.2.0 и cURL 7.73.0).

  4. Руководство PHP: curl_errno и curl_getinfo

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: curl_errno() возвращает номер ошибки последней операции или 0; curl_error() возвращает сообщение; curl_getinfo() возвращает ключи http_code, total_time, connect_time, primary_ip и другие.

  5. Документация Guzzle: Request options

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: опция proxy принимает строку для всех протоколов или массив с ключами http, https и no; логин и пароль можно указать в URL прокси; NO_PROXY читается автоматически, только если вы не передали свою опцию proxy; connect_timeout и timeout — числа с плавающей точкой, значение по умолчанию 0 означает ждать бесконечно; http_errors по умолчанию true и превращает 4xx и 5xx в исключения.

    Страница не упоминает SOCKS5.

  6. Документация Guzzle: Exceptions

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: TransferException — базовый класс; ConnectException выбрасывается при сетевой ошибке; RequestException — родитель BadResponseException (ClientException для 4xx, ServerException для 5xx) и TooManyRedirectsException.

  7. Исходный код Guzzle: обработчик cURL (7.9)

    Официальная документация · Проверено:

    Прочитано 17 ноября 2026: строковая опция proxy копируется в CURLOPT_PROXY; параметры из массива curl заменяют параметры cURL обработчика; ConnectException создаётся только для ошибок cURL 28, 6, 7, 35 и 52, а любая другая ошибка cURL (например 5, 56 и 97) становится RequestException.

  8. Информация о продуктах и цены Proxy302

    Наблюдение за продуктом · Проверено:

    Файл с данными о продуктах сайта, сверен 10 ноября 2026 с консолью, бэкендом и прайс-листом: аренда IP дата-центра $0,25 за 1 день и $3,99 за 30 дней, одинаково во всех странах; HTTP порт 2222 и SOCKS5 порт 3333; один протокол на арендованный IP; ротационные резидентные на proxy.proxy302.com с одним логином для обоих протоколов; до 100 штук в заказе; бесплатного пробного периода нет.

Готовы попробовать?

Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.