НовинкаБезлимитные резидентные прокси: трафик без учёта объёма по фиксированной цене. От $33,25/день

PHP · Руководство по интеграции

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

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

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

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

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

Уже наш клиент? Имя пользователя и пароль — в личном кабинете.

  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-эндпоинте.

Готовы подключить прокси? Получите учётные данные

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

  • Оплата по мере использования
  • Мгновенная активация
  • Принимаем криптовалюту
  • Без автопродления