最简单方式是用file_get_contents('https://api.ipify.org')获取公网IP,需确保allow_url_fopen开启;若禁用则改用curl并设置超时、错误处理等。

用 file_get_contents 调外部 API 获取公网 IP 最简单
PHP 本身没有内置函数能直接拿到本机公网 IP,因为“公网 IP”是你的路由器或运营商分配给整个网络的出口地址,不是本机网卡配置的地址。必须通过 HTTP 请求一个能返回客户端真实外网 IP 的公开服务来获取。
最常用、最轻量的方式就是用 file_get_contents 直接抓取响应体:
echo file_get_contents('https://api.ipify.org');
这个地址只返回纯文本格式的 IPv4 地址,无 JSON 包裹,无额外空格,适合直接使用。注意必须启用 allow_url_fopen(默认开启),否则会报错 Warning: file_get_contents(): failed to open stream: no suitable wrapper。
- 如果服务器禁用了
allow_url_fopen,就得换curl - 部分国内服务器访问国外域名可能超时或被 DNS 污染,可备用国内接口如
https://myip.ipip.net(返回含中文的文本,需正则提取) - 不要用
http://开头的接口,HTTP 明文易被中间设备篡改或劫持,强制用 HTTPS
curl 方式更可控,适合生产环境
当需要设置超时、重试、User-Agent 或处理错误时,curl 是更稳妥的选择。它不依赖 allow_url_fopen,且能明确捕获连接失败、HTTP 状态码异常等细节。
立即学习“PHP免费学习笔记(深入)”;
示例代码:
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.ipify.org');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_setopt($ch, CURLOPT_USERAGENT, 'PHP-curl');
$ip = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code === 200 && !empty(trim($ip))) {
echo trim($ip);
} else {
error_log("Failed to fetch public IP: HTTP {$http_code}, response: " . var_export($ip, true));
}
-
CURLOPT_TIMEOUT必须设,避免请求卡死影响主流程 -
trim()很关键,有些接口(如https://icanhazip.com)末尾带换行符 - 别忽略
CURLINFO_HTTP_CODE,某些 CDN 或防火墙会返回 403/503 却仍输出内容
别混淆 $_SERVER['SERVER_ADDR'] 和真实公网 IP
很多新手会误用 $_SERVER['SERVER_ADDR'] 或 gethostbyname(gethostname()),这些返回的是服务器本地网卡地址(比如 192.168.1.100 或 172.18.0.3),在 Docker、Nginx 反代、云厂商内网环境下完全不是公网 IP。
如果你的应用部署在阿里云 ECS、腾讯云 CVM 或轻量应用服务器上,SERVER_ADDR 返回的是内网 IP;只有通过公网 NAT 出去的流量,其源 IP 才是你要取的那个。
- 反向代理场景下,客户端真实公网 IP 通常在
$_SERVER['HTTP_X_FORWARDED_FOR']或$_SERVER['HTTP_X_REAL_IP'],但这只是请求头传来的,不可信,不能当作“本机公网 IP” - 所谓“本机公网 IP”,指的是这台服务器对外发起请求时,对方看到的那个 IP —— 只能靠外部 API 回显确认
多个接口对比与容灾建议
单一接口有挂掉风险,线上项目建议准备 2–3 个备用地址,并加简单重试逻辑。以下是几个实测可用的接口及其特点:
-
https://api.ipify.org:响应快,纯 IPv4,无证书问题,推荐作为首选 -
https://api64.ipify.org:返回 IPv6 地址(如有) -
https://icanhazip.com:返回 IPv4,末尾带\n,需trim() -
https://myip.ipip.net:返回中文描述,需用preg_match('/(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})/', $res, $m)提取
真正容易被忽略的是:所有这些方式都依赖外部服务可用性。如果你的业务对公网 IP 有强依赖(比如动态注册白名单、生成临时凭证),得考虑缓存 + 定期刷新机制,而不是每次请求都实时调用。











