PHP cURL и Guzzle через прокси: настройка и ошибки
Опции прокси в PHP cURL и Guzzle, безопасные тайм-ауты и способ понять, откуда ошибка: от прокси или от целевого сайта.
Один и тот же прокси в cURL и в Guzzle
Один и тот же прокси в cURL и в Guzzle
Пункт
PHP cURL
Guzzle
Адрес и протокол прокси
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.
В примере прокси задан со схемой, логин передан через CURLOPT_PROXYUSERPWD, оба тайм-аута установлены. Когда логин передаётся отдельно, спецсимволы в пароле кодировать не нужно; на странице libcurl, которую мы читали, не сказано, декодируются ли логин и пароль внутри строки прокси. Используйте socks5h://, если имя целевого сайта должен разрешать прокси.
После curl_exec() прочитайте три значения: curl_errno() (0 — ошибки cURL нет), CURLINFO_HTTP_CODE (ответ целевого сайта) и CURLINFO_HTTP_CONNECTCODE (ответ прокси на CONNECT). Вместе они показывают, виноват прокси или сайт.
Документированная опция 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.
<?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
Выберите продукт на странице автоматизации. IP дата-центра стоит $0,25 за 1 день или $3,99 за 30 дней, одинаково во всех странах; ротационные резидентные оплачиваются за ГБ. Бесплатного пробного периода нет.
Откройте «Мои активы» и скопируйте HOST, PORT, USERNAME и PASSWORD. У арендованного IP один протокол, выбранный при покупке: HTTP на порту 2222 или SOCKS5 на порту 3333.
Шаг 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 на один день.
Прочитано 17 ноября 2026: допустимые схемы http://, https://, socks4://, socks4a://, socks5:// и socks5h:// (socks5h — имя хоста разрешает прокси); без порта используется 1080; логин и пароль можно писать в строке или задавать через CURLOPT_PROXYUSERNAME и CURLOPT_PROXYPASSWORD; опция приоритетнее переменных окружения прокси; пустая строка отключает прокси.
Страница не говорит, нужно ли кодировать логин и пароль в строке.
Прочитано 17 ноября 2026: 5 — не удалось разрешить хост прокси, 6 — не удалось разрешить хост цели, 7 — не удалось установить соединение с целью или прокси, 28 — истекло время, 35 — сбой TLS-рукопожатия, 52 — ничего не получено, 55 — сбой отправки, 56 — сбой приёма, 97 — сбой рукопожатия с прокси (подробности в CURLINFO_PROXY_ERROR).
Прочитано 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).
Прочитано 17 ноября 2026: curl_errno() возвращает номер ошибки последней операции или 0; curl_error() возвращает сообщение; curl_getinfo() возвращает ключи http_code, total_time, connect_time, primary_ip и другие.
Прочитано 17 ноября 2026: опция proxy принимает строку для всех протоколов или массив с ключами http, https и no; логин и пароль можно указать в URL прокси; NO_PROXY читается автоматически, только если вы не передали свою опцию proxy; connect_timeout и timeout — числа с плавающей точкой, значение по умолчанию 0 означает ждать бесконечно; http_errors по умолчанию true и превращает 4xx и 5xx в исключения.
Прочитано 17 ноября 2026: TransferException — базовый класс; ConnectException выбрасывается при сетевой ошибке; RequestException — родитель BadResponseException (ClientException для 4xx, ServerException для 5xx) и TooManyRedirectsException.
Прочитано 17 ноября 2026: строковая опция proxy копируется в CURLOPT_PROXY; параметры из массива curl заменяют параметры cURL обработчика; ConnectException создаётся только для ошибок cURL 28, 6, 7, 35 и 52, а любая другая ошибка cURL (например 5, 56 и 97) становится RequestException.
Информация о продуктах и цены Proxy302
Наблюдение за продуктом · Проверено:
Файл с данными о продуктах сайта, сверен 10 ноября 2026 с консолью, бэкендом и прайс-листом: аренда IP дата-центра $0,25 за 1 день и $3,99 за 30 дней, одинаково во всех странах; HTTP порт 2222 и SOCKS5 порт 3333; один протокол на арендованный IP; ротационные резидентные на proxy.proxy302.com с одним логином для обоих протоколов; до 100 штук в заказе; бесплатного пробного периода нет.
Готовы попробовать?
Создайте аккаунт, пополните баланс и выберите ротируемый резидентный, статический ISP или дата-центр IP — настроить его в браузере можно за несколько минут.