-
检查 cURL 扩展
大多数 PHP 构建版本都包含 cURL 扩展;开始之前,请确认它已加载。只有在您更喜欢使用更高层的客户端时,才需要用 Composer 安装 Guzzle。
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 或保持同一 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; } -
使用 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; -
读取网关状态码并重试
对于 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 端点上的用法完全相同。
