新品不限流量住宅代理:固定价格,流量不计量。 低至 $33.25/天

PHP · 集成指南

如何在 PHP 中使用代理

PHP 可通过 cURL 扩展或 Guzzle(其底层同样基于 cURL)连接 Proxonym 网关。本指南涵盖身份认证、地理定位、轮换 IP 与粘性 IP、SOCKS5 以及重试。

  • 共 6 步
  • 12 分钟完成配置
  • 复制即用的代码

开始之前

  • PHP 8.1 或更高版本,并启用 cURL 扩展
  • Composer 和 Guzzle 7,用于 Guzzle 示例(可选)
  • Proxonym 住宅代理或移动代理套餐
获取代理凭据

已是客户?您的用户名和密码就在控制台中。

  1. 检查 cURL 扩展

    大多数 PHP 构建版本都包含 cURL 扩展;开始之前,请确认它已加载。只有在您更喜欢使用更高层的客户端时,才需要用 Composer 安装 Guzzle。

    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 或保持同一 IP

    每个新的 cURL 句柄都会建立新连接,而不带会话参数时,每个新连接都会获得一个新 IP。借助上一步的辅助函数,添加一个最多 32 位字母和数字的会话 ID,即可将同一 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 通过 proxy 选项接收完整的代理 URL(包括凭据)。将协议前缀改为 socks5h://、端口改为 1080,即可使用 SOCKS5,并由代理端解析 DNS。

    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;

常见问题

在 PHP 中如何查看 HTTPS 请求的网关状态码?

在 curl_exec 之后调用 curl_getinfo($ch, CURLINFO_HTTP_CONNECTCODE)。对于 HTTPS 目标,它会返回网关响应 CONNECT 请求时发送的状态码;而 CURLINFO_RESPONSE_CODE 返回的是目标网站的状态码。407 表示凭据错误,402 表示余额已用完或套餐已过期,403 表示目标网站已被屏蔽。

Guzzle 能使用 Proxonym 代理吗?

可以。在 proxy 选项中传入完整的代理 URL,既可以在客户端上设置,也可以在单个请求上设置以覆盖客户端的配置。您还可以传入一个分别包含 http 和 https 条目的数组。Guzzle 会将 URL 交给 cURL 处理,因此 1080 端口上的 socks5h:// URL 同样可用,用户名参数也相同。

为什么多个请求共用同一个 IP?

这些请求很可能复用了同一个 cURL 句柄,该句柄会保持与网关的连接,而网关是按连接分配 IP 的。如果每个请求都需要新 IP,请为每个请求新建句柄,或将 CURLOPT_FRESH_CONNECT 设为 true。如果需要稳定的 IP,则保留句柄并使用会话 ID。

PHP 可以使用 SOCKS5 端点吗?

可以。将 CURLOPT_PROXY 设为 socks5h://gw.proxonym.com:1080,CURLOPT_PROXYUSERPWD 保持不变。socks5h 协议前缀会让代理解析主机名,因此 DNS 查询不会在您的服务器上进行。用户名中的定位、会话和 lifetime 参数,与在 HTTP 端点上的用法完全相同。

准备好接入了吗?立即获取凭据

选择套餐,从控制台复制用户名和密码,然后运行上面的代码。

  • 按量付费
  • 即时开通
  • 支持加密货币
  • 不自动续费