PHP 是什么？如何在 PHP 中使用代理 IP？

PHP 是常用的服务端脚本语言，广泛用于网站开发、API 对接和数据处理。

PHP 程序默认通过服务器的网络出口发起请求；如果业务需要切换访问地区、轮换出口 IP 或长期使用固定 IP，就可以配置代理。

本文介绍如何在 PHP 中配置 HTTP 和 SOCKS5 代理，以及如何处理认证失败、连接超时和出口验证问题。

PHP 是什么？为什么需要代理 IP？

PHP 是开源的服务器端脚本语言，主要用来生成网页和提供接口。

据 W3Techs 统计，在可识别服务端编程语言的网站中，约 69% 使用 PHP。

把请求交给代理，通常出于三个理由：

▸ 出口分散：采集公开页面、监测价格时请求集中，出口 IP 容易被目标站点限制，把请求分摊到不同节点更稳妥。

▸ 地区一致：跨境业务或广告验证需要从目标国家或地区的网络发起请求，而不是从服务器所在机房发出。

▸ 出口固定：后台登录、接口白名单这类场景需要长期使用同一个地址，方便登记和核对。

代理改变的是请求出口，不改变请求频率、并发数和账号状态。频率之外的问题，换代理不一定有用。

如何在 PHP 中使用代理 IP？

PHP 发起外部请求主要靠 cURL 扩展和 Stream 函数（file_get_contents() 一类），下面的示例分别对应。

开始前先执行 php -m，输出里有 curl 说明扩展已启用；Stream 方式还要求 allow_url_fopen 为 On。

示例中的地址、端口和账号是占位值，使用时换成服务商给的实际参数；出口是否生效，用 https://httpbin.org/ip 这类回显接口比对即可。

1. 使用 cURL 配置 HTTP 代理

<?php
// 需启用 cURL 扩展：php -m | grep curl
$ch = curl_init('https://httpbin.org/ip');

curl_setopt_array($ch, [
    CURLOPT_PROXY          => '123.123.123.123:8888', // 换成服务商提供的地址与端口
    CURLOPT_PROXYTYPE      => CURLPROXY_HTTP,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10,                     // 建立连接的上限秒数
    CURLOPT_TIMEOUT        => 20,                     // 整个请求的上限秒数
]);

$body   = curl_exec($ch);
$errno  = curl_errno($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($errno !== 0) {
    echo 'cURL 错误（' . $errno . '）：' . curl_error($ch);
} elseif ($status !== 200) {
    echo 'HTTP 状态码：' . $status;
} else {
    echo $body;
}

curl_close($ch);
?>

设置代理地址与类型，限制连接与总耗时，再把结果分成网络层报错、状态码异常、正常响应三类。

curl_errno() 返回 0 只说明链路没报错，不代表站点接受了请求，所以还要看 curl_getinfo() 拿到的状态码。

访问 HTTPS 目标时，cURL 通过 HTTP 代理通常会自动用 CONNECT 建立隧道，前提是代理支持这种方式。

2. 使用 cURL 配置 SOCKS5 代理及账号密码

<?php
$ch = curl_init('https://httpbin.org/ip');

curl_setopt_array($ch, [
    CURLOPT_PROXY          => '123.123.123.123:1080',  // SOCKS5 端口以服务商说明为准
    CURLOPT_PROXYTYPE      => CURLPROXY_SOCKS5,
    CURLOPT_PROXYUSERPWD   => 'your_username:your_password',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT        => 20,
]);

$body   = curl_exec($ch);
$errno  = curl_errno($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($errno !== 0) {
    echo 'cURL 错误（' . $errno . '）：' . curl_error($ch);
} elseif ($status !== 200) {
    echo 'HTTP 状态码：' . $status;
} else {
    echo $body;
}

curl_close($ch);
?>

账号密码用 CURLOPT_PROXYUSERPWD 单独传入，不拼进代理地址——密码含 @、:、/ 时，拼进 URL 容易被解析错误。

需要域名在代理侧解析，把类型换成 CURLPROXY_SOCKS5_HOSTNAME。

生产环境的账号密码放环境变量，不要提交进仓库。

3. 使用 file_get_contents() 配置 HTTP 代理

<?php
// 依赖 allow_url_fopen=On，仅演示 HTTP 代理的基础请求
$proxy = 'tcp://123.123.123.123:8888';
$auth  = base64_encode('your_username:your_password');

$context = stream_context_create([
    'http' => [
        'proxy'           => $proxy,
        'request_fulluri' => true,
        'header'          => "Proxy-Authorization: Basic {$auth}\r\n",
        'timeout'         => 20,
    ],
]);

$body = @file_get_contents('http://httpbin.org/ip', false, $context);

if ($body === false) {
    echo '请求失败：检查代理地址、认证信息与 allow_url_fopen 设置';
} else {
    echo $body;
}
?>

这一方式只覆盖 HTTP 代理的基础请求：proxy 指定地址，request_fulluri 置 true 后请求行使用完整 URL，认证头要自己拼。

换成 HTTPS 目标、SOCKS5 或更复杂的认证，用 cURL。

PHP 代理 IP 配置失败怎么办？

出错时先分两类：cURL 错误码说明链路，HTTP 状态码说明站点或代理的回应。

1. 407 认证失败

407 由代理返回，表示代理要求认证。核对账号密码是否正确、有没有多余空格；服务商用 IP 白名单校验时，还要把运行脚本的服务器出口 IP 加进后台。

407 与目标站点返回的 401 不是一回事，前者在代理层，后者在应用层。

2. 连接超时或连接被拒绝

curl_errno() 返回 7，多为连不上代理地址或端口；返回 28，是超过 CURLOPT_TIMEOUT 或 CURLOPT_CONNECTTIMEOUT。先确认端口通不通：

telnet 123.123.123.123 1080

也可以换成 nc -vz 123.123.123.123 1080。

端口测试返回 “Connection refused”，一般意味着端口没开或该端口不提供这种协议；显示超时，则更像网络层不通或被防火墙拦住。

端口通但请求仍失败，多半是协议填错——把 SOCKS5 端口按 HTTP 代理去连，通常直接失败。调大超时只能缓解慢，解决不了连不上。

3. 如何验证代理出口 IP

请求一个回显 IP 的接口，比如 https://httpbin.org/ip，看返回地址是不是代理 IP；

也可以用 IP 检测工具同时看出口地址、ASN 与地区是否与购买节点一致。只有返回的地址确实是代理 IP、状态码正常，才算配置生效。

403 是目标站点拒绝了这次请求，407 是代理认证没过，429 是频率限制，三者的处理方式不同，别一看到失败就换 IP。

PHP 项目应该选择哪种代理 IP？

选择代理时，还要确认支持的协议、认证方式和并发限制。

IPDEEP 提供动态住宅代理和静态住宅代理，支持 HTTP、HTTPS 和 SOCKS5 协议。

具体地区与套餐参数以产品页面为准。

配置完成后，可以通过出口 IP 检测确认请求是否经过代理。

PHP 使用代理 IP 的常见问题

Q1：HTTP 与 SOCKS5 怎么选？

网页请求用 HTTP 代理就够，配置和排查都简单；SOCKS5 在传输层转发、不解析 HTTP 头，能承载更多类型的连接，需要代理侧解析域名时也更合适。

多数服务商两种都提供，选一种跑通即可。

Q2：配置代理后，为什么仍然出现 403 或 429？

403 是目标站点拒绝了这次请求，可能与该 IP 的地区、历史记录、请求头或账号权限有关；429 是频率限制，说明请求太快或并发太高。

两者都不属于代理认证问题，先降频、加间隔重试，再判断是否需要更换出口。