PHP 8.1 中仅设 CURLOPT_PROXY 不够，因 cURL 默认按 HTTP 代理处理；必须显式设置 CURLOPT_PROXYTYPE 为 CURLPROXY_SOCKS5 或 CURLPROXY_SOCKS5_HOSTNAME 才能正确走 SOCKS5 协议。
PHP 8.1 中用 cURL 发起请求时，必须显式指定 CURLOPT_PROXYTYPE 为 CURLPROXY_SOCKS5（或 CURLPROXY_SOCKS5_HOSTNAME），否则即使填了 CURLOPT_PROXY，cURL 仍会按 HTTP 代理处理，连接直接失败。
为什么只设 CURLOPT_PROXY 不够
cURL 默认把 CURLOPT_PROXY 当作 HTTP 代理。SOCKS5 是完全不同的协议栈，不声明类型就会在握手阶段卡住或返回 Failed to connect to proxy 类错误。PHP 8.1 的 cURL 扩展不会自动推断协议类型，这点和 Python 的 requests 不同。
- 错误写法：
curl_setopt($ch, CURLOPT_PROXY, '127.0.0.1:1080')→ 实际走 HTTP CONNECT，目标服务器收不到 SOCKS5 请求 - 正确写法：必须配对使用
CURLOPT_PROXY和CURLOPT_PROXYTYPE - 若代理地址含用户名密码，格式必须是
socks5://user:pass@host:port或通过CURLOPT_PROXYUSERPWD单独传，不能混用
CURLPROXY_SOCKS5 和 CURLPROXY_SOCKS5_HOSTNAME 的区别
两者都走 SOCKS5 协议，关键差异在 DNS 解析环节：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
-
CURLPROXY_SOCKS5：客户端本地解析域名，再把 IP 发给代理 → 可能泄露真实访问目标（DNS 泄露） -
CURLPROXY_SOCKS5_HOSTNAME：把原始域名发给 SOCKS5 服务器，由它完成解析 → 隐私更强，推荐用于爬虫或敏感场景 - 注意：不是所有 SOCKS5 服务端都支持 hostname 模式（比如部分 Dante 配置需开启
internalip或method选项），连不上时可先降级测试CURLPROXY_SOCKS5
带认证的完整 cURL 配置示例
以下代码在 PHP 8.1+ 环境下可直接运行，已验证兼容 ext-curl 8.0+ 版本：
立即学习“PHP免费学习笔记（深入）”；
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://httpbin.org/ip');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_PROXY, '127.0.0.1:1080');
curl_setopt($ch, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5_HOSTNAME);
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'myuser:mypass');
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo 'cURL error: ' . curl_error($ch);
} else {
echo $response;
}
curl_close($ch);
- 不要用
http://或socks5://前缀写在CURLOPT_PROXY值里 —— cURL 会报Unsupported proxy type -
CURLOPT_PROXYUSERPWD必须在CURLOPT_PROXYTYPE之后设置，顺序错会导致认证被忽略 - PHP 8.1 的
PgSql\Connection类与 SOCKS5 无关，别误以为能用它配置代理
最容易被忽略的是 DNS 解析模式的选择：很多开发者调通了连接就以为万事大吉，但没意识到本地解析域名会让目标网站看到你的真实出口 IP 段，尤其在反爬严格的站点上，CURLPROXY_SOCKS5_HOSTNAME 才是真正“全链路代理”的关键一环。
