-
Проверьте расширение cURL
Большинство сборок PHP включает расширение cURL; перед началом убедитесь, что оно загружено. Устанавливайте Guzzle через Composer, только если предпочитаете более высокоуровневый клиент.
Shell php -m | grep -i curl composer require guzzlehttp/guzzle # optional -
Отправьте запрос через шлюз
Укажите шлюз через
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; -
Укажите страну, штат, город или 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; -
Меняйте 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; } -
Используйте 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; -
Обрабатывайте коды состояния шлюза и повторяйте запросы
Для 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-эндпоинте.
