---
title: "PHP 代理设置：cURL 与 Guzzle | Proxonym"
description: "在 PHP 中通过 cURL 扩展或 Guzzle 使用代理：身份验证、轮换与粘性 IP、地理定位、SOCKS5 以及网关错误处理。"
url: https://proxonym.com/zh/integrations/php
updated: 2026-10-02T03:03:46+00:00
---

# 如何在 PHP 中使用代理

PHP 可通过 cURL 扩展或 Guzzle（其底层同样基于 cURL）连接 Proxonym 网关。本指南涵盖身份认证、地理定位、轮换 IP 与粘性 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 扩展；开始之前，请确认它已加载。只有在您更喜欢使用更高层的客户端时，才需要用 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 端点上的用法完全相同。

技巧与注意事项

- 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/zh/blog/socks5-vs-http-proxies)
- [网页抓取防封禁：12 个实用技巧](https://proxonym.com/zh/blog/web-scraping-without-getting-blocked)

卡在某一步了？

大多数故障都可以从错误代码中找到原因。请先查看错误代码，再单独测试代理。

- [帮助中心](https://proxonym.com/zh/help)
- [网关错误代码](https://proxonym.com/zh/docs#errors-and-troubleshooting)
- [测试您的代理](https://proxonym.com/zh/proxy-checker)

## 更多集成指南

[全部集成](https://proxonym.com/zh/integrations)

- [AdsPower (指纹浏览器)](https://proxonym.com/zh/integrations/adspower)
- [cURL (命令行)](https://proxonym.com/zh/integrations/curl)
- [Go](https://proxonym.com/zh/integrations/go)
