---
title: "Прокси в PHP: cURL и Guzzle | Proxonym"
description: "Как использовать прокси в PHP с расширением cURL или Guzzle: аутентификация, IP с ротацией и sticky-IP, геотаргетинг, SOCKS5 и обработка ошибок шлюза."
url: https://proxonym.com/ru/integrations/php
updated: 2026-10-02T03:03:46+00:00
---

# Как использовать прокси в PHP

PHP подключается к шлюзу Proxonym через расширение cURL или через Guzzle, который сам работает поверх cURL. В руководстве: аутентификация, таргетинг по местоположению, ротация и закрепление IP, SOCKS5 и повторные попытки.

- 6 шагов
- Настройка за 12 мин
- Готовый код для копирования

Перед началом работы

- PHP 8.1 или новее с расширением cURL
- Composer и Guzzle 7 для примера с Guzzle (необязательно)
- Тариф Proxonym на резидентные или мобильные прокси

Параметры подключения

- **Хост**: `gw.proxonym.com`
- **HTTP**: `8000`
- **SOCKS5**: `1080`
- **Пользователь**: `USERNAME-country-us`

1. **Проверьте расширение cURL**: Большинство сборок PHP включает расширение cURL; перед началом убедитесь, что оно загружено. Устанавливайте Guzzle через Composer, только если предпочитаете более высокоуровневый клиент. Shell `php -m | grep -i curl composer require guzzlehttp/guzzle # optional`
2. **Отправьте запрос через шлюз**: Укажите шлюз через `CURLOPT_PROXY`, а учётные данные — через `CURLOPT_PROXYUSERPWD`. HTTPS-сайты автоматически туннелируются через CONNECT. PHP `<?php $ch = curl_init('https://api.ipify.org'); curl_setopt_array($ch, [ CURLOPT_PROXY => 'http://gw.proxonym.com:8000', CURLOPT_PROXYUSERPWD => 'USERNAME:PASSWORD', CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60, ]); $ip = curl_exec($ch); echo $ip === false ? 'Error: ' . curl_error($ch) : 'Exit IP: ' . $ip, PHP_EOL;`
3. **Укажите страну, штат, город или ASN**: Эта вспомогательная функция добавляет параметры к имени пользователя в том порядке, который ожидает шлюз. Используйте коды стран ISO строчными буквами и подчёркивания вместо пробелов, а также выбирайте либо штат, либо город, но не оба сразу. PHP `<?php function proxonym_user(array $params = []): string { $user = 'USERNAME'; foreach (['country', 'state', 'city', 'asn', 'session', 'lifetime'] as $key) { if (isset($params[$key])) { $user .= "-{$key}-{$params[$key]}"; } } return $user; } function fetch_via_proxy(string $url, string $user): string { $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_PROXY => 'http://gw.proxonym.com:8000', CURLOPT_PROXYUSERPWD => $user . ':PASSWORD', CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60, ]); $body = curl_exec($ch); return $body === false ? 'error: ' . curl_error($ch) : $body; } echo fetch_via_proxy('https://ipinfo.io/json', proxonym_user(['country' => 'gb', 'city' => 'london'])), PHP_EOL; echo fetch_via_proxy('https://ipinfo.io/json', proxonym_user(['country' => 'us', 'state' => 'texas'])), PHP_EOL; echo fetch_via_proxy('https://ipinfo.io/json', proxonym_user(['country' => 'us', 'asn' => 7922])), PHP_EOL;`
4. **Меняйте IP или сохраняйте один и тот же**: Каждый новый дескриптор cURL открывает новое подключение, а без параметра сессии каждое новое подключение получает новый IP. С помощью вспомогательных функций из предыдущего шага добавьте ID сессии длиной до 32 букв и цифр, чтобы сохранять один IP до 120 минут. PHP `// Rotating: a new exit IP for every handle for ($i = 0; $i < 3; $i++) { echo 'rotating ', fetch_via_proxy('https://api.ipify.org', proxonym_user(['country' => 'us'])), PHP_EOL; } // Sticky: the same exit IP for up to 30 minutes $sticky = proxonym_user(['country' => 'us', 'session' => bin2hex(random_bytes(4)), 'lifetime' => 30]); for ($i = 0; $i < 3; $i++) { echo 'sticky ', fetch_via_proxy('https://api.ipify.org', $sticky), PHP_EOL; }`
5. **Используйте Guzzle или SOCKS5**: Guzzle принимает полный URL прокси вместе с учётными данными в опции `proxy`. Чтобы использовать SOCKS5 с разрешением DNS на стороне прокси, смените схему на `socks5h://`, а порт — на 1080. PHP `<?php require 'vendor/autoload.php'; use GuzzleHttp\Client; $http = new Client([ 'proxy' => 'http://USERNAME-country-de:PASSWORD@gw.proxonym.com:8000', 'timeout' => 60, ]); echo 'HTTP: ', $http->get('https://api.ipify.org')->getBody(), PHP_EOL; $socks = new Client([ 'proxy' => 'socks5h://USERNAME-country-de:PASSWORD@gw.proxonym.com:1080', 'timeout' => 60, ]); echo 'SOCKS5: ', $socks->get('https://api.ipify.org')->getBody(), PHP_EOL;`
6. **Обрабатывайте коды состояния шлюза и повторяйте запросы**: Для HTTPS-сайтов `CURLINFO_HTTP_CONNECTCODE` содержит статус шлюза для запроса CONNECT. При 429, 502 и 504 повторяйте запрос после паузы, а при 402, 403 или 407 останавливайтесь: повторные попытки здесь не помогут. PHP `<?php function fetch_with_retry(string $url, string $user, int $tries = 3): string { for ($attempt = 1; $attempt <= $tries; $attempt++) { $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_PROXY => 'http://gw.proxonym.com:8000', CURLOPT_PROXYUSERPWD => $user . ':PASSWORD', CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60, ]); $body = curl_exec($ch); $gateway = curl_getinfo($ch, CURLINFO_HTTP_CONNECTCODE); $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE); if ($body !== false && $status !== 429 && $status < 500) { return $body; } if (in_array($gateway, [402, 403, 407], true)) { throw new RuntimeException("Gateway refused the request with status $gateway"); } sleep($attempt); } throw new RuntimeException("Request failed after $tries attempts"); } echo strlen(fetch_with_retry('https://example.com', 'USERNAME-country-us')), ' bytes', PHP_EOL;`

## Часто задаваемые вопросы

### Как увидеть статус шлюза для HTTPS-запросов в PHP?

Вызовите curl_getinfo($ch, CURLINFO_HTTP_CONNECTCODE) после curl_exec. Для HTTPS-сайтов этот вызов возвращает статус, который шлюз отправил в ответ на запрос CONNECT, тогда как CURLINFO_RESPONSE_CODE возвращает статус целевого сайта. 407 означает неверные учётные данные, 402 — пустой баланс или истёкший тариф, а 403 — заблокированный целевой сайт.

### Работает ли Guzzle с прокси Proxonym?

Да. Передайте полный URL прокси в опции proxy — на уровне клиента или в отдельном запросе, чтобы переопределить настройку клиента. Можно также передать массив с отдельными ключами http и https. Guzzle передаёт URL в cURL, поэтому URL вида socks5h:// на порту 1080 тоже работают, с теми же параметрами имени пользователя.

### Почему у нескольких запросов один и тот же IP?

Скорее всего, они используют один дескриптор cURL, который держит подключение к шлюзу открытым, а шлюз назначает IP на каждое подключение. Если каждому запросу нужен новый IP, создавайте новый дескриптор для каждого запроса или установите CURLOPT_FRESH_CONNECT в true. Если нужен стабильный IP, сохраняйте дескриптор и используйте ID сессии.

### Можно ли подключаться к SOCKS5-эндпоинту из PHP?

Да. Установите CURLOPT_PROXY в socks5h://gw.proxonym.com:1080, а CURLOPT_PROXYUSERPWD оставьте как есть. Схема socks5h заставляет прокси разрешать имена хостов, так что DNS-запросы не выполняются на вашем сервере. Параметры таргетинга, сессии и времени жизни в имени пользователя работают точно так же, как на HTTP-эндпоинте.

Советы и подводные камни

- CURLOPT_PROXYUSERPWD принимает имя пользователя и пароль открытым текстом, поэтому спецсимволы в нём не нужно кодировать для URL — в отличие от учётных данных внутри URL прокси.
- Повторное использование одного дескриптора cURL сохраняет его подключение открытым, а значит, и выходной IP; установите CURLOPT_FRESH_CONNECT в true, если каждый вызов должен открывать новое подключение.
- Выполняйте запросы параллельно с помощью curl_multi_exec или Guzzle Pool, а не перебирайте блокирующие вызовы в цикле.
- Вызывать curl_close() не нужно: начиная с PHP 8.0 эта функция ничего не делает, а дескрипторы освобождаются, когда выходят из области видимости.

Читайте также

- [SOCKS5 или HTTP-прокси: различия протоколов, которые имеют значение](https://proxonym.com/ru/blog/socks5-vs-http-proxies)
- [Парсинг без блокировок: 12 практических приёмов](https://proxonym.com/ru/blog/web-scraping-without-getting-blocked)

Застряли на каком-то шаге?

Большинство сбоев сводится к коду ошибки. Сначала проверьте его, затем протестируйте сам прокси отдельно.

- [Справочный центр](https://proxonym.com/ru/help)
- [Коды ошибок шлюза](https://proxonym.com/ru/docs#errors-and-troubleshooting)
- [Проверить прокси](https://proxonym.com/ru/proxy-checker)

## Другие руководства по интеграции

[Все интеграции](https://proxonym.com/ru/integrations)

- [AdsPower (Антидетект-браузер)](https://proxonym.com/ru/integrations/adspower)
- [cURL (Командная строка)](https://proxonym.com/ru/integrations/curl)
- [Go](https://proxonym.com/ru/integrations/go)
