最可靠方式是调用公网HTTP接口如https://api.ipify.org，返回纯文本IP；需加cURL超时与错误处理，且必须校验IP有效性，避免误用$_SERVER['SERVER_ADDR']或gethostbyname()等不可靠方法。
用 curl 调用公网接口查本机出口 IP 最可靠
PHP 本身没有内置函数能直接获取“出口 IP”（即外网可见的 IP），因为这个地址由 NAT 或运营商分配，不在本地网络栈中。最稳妥的方式是调用一个可信的公网 HTTP 接口，让它返回请求来源的 IP。
常见可用接口有：https://api.ipify.org、https://ifconfig.me/ip、https://icanhazip.com。它们都只返回纯文本 IP，无额外格式，适合脚本解析。
- 推荐优先用
https://api.ipify.org：响应快、无跨域/重定向干扰、长期稳定 - 避免用带 HTML 的页面（比如某些 ifconfig.me 子路径），否则需额外
strip_tags()或正则提取 - 务必加超时和错误处理——网络不可达时不能卡住整个脚本
function getPublicIp(): ?string
{
$url = 'https://api.ipify.org';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false);
$ip = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200 && filter_var(trim($ip), FILTER_VALIDATE_IP)) {
return trim($ip);
}
return null;
}
查默认网关对应 IP（即路由器 LAN 口地址）要用系统命令 + 解析
PHP 没有跨平台 API 直接读取默认网关 IP，但可通过执行系统命令获取路由表，再提取目标为 0.0.0.0 或 default 的那行的 Gateway 字段。
不同系统命令不同：
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：用
ip route show default（推荐）或netstat -rn | grep '^0.0.0.0\|default' - Windows：用
route print -4 \| findstr \" 0.0.0.0\"（注意空格数量，匹配 IPv4 默认路由） - 不要用
gethostbyname(gethostname())——它返回的是本机 hostname 解析结果，通常只是127.0.0.1或内网 IP，不是网关
// 简单示例（仅 Linux）
function getDefaultGateway(): ?string
{
$output = [];
$returnCode = 0;
exec('ip route show default | awk \'{print $3}\' 2>/dev/null', $output, $returnCode);
if ($returnCode === 0 && !empty($output[0]) && filter_var($output[0], FILTER_VALIDATE_IP)) {
return $output[0];
}
return null;
}
$_SERVER['SERVER_ADDR'] 和 gethostbyname() 都不是出口 IP
这两个是最常被误用的方案，必须明确排除：
-
$_SERVER['SERVER_ADDR']是当前 PHP 所在 Web 服务器绑定的本地 IP（如192.168.1.100或127.0.0.1），跟出口无关 -
gethostbyname(gethostname())查的是本机名反解，依赖 hosts 或 DNS 配置，极不可靠；在 Docker 容器里往往返回127.0.0.11（dockerd 内置 DNS） - 即使服务器是裸金属且没 NAT，
$_SERVER['SERVER_ADDR']也可能是内网地址（比如绑在私有网段），不代表对外暴露地址
出口 IP 查询失败时别 fallback 到局域网地址
线上服务如果查不到公网 IP，直接返回 null 或抛异常比硬塞一个 192.168.x.x 更安全。很多业务逻辑（比如白名单校验、地域限制）依赖真实出口 IP，用错会导致静默故障。
尤其注意：
- Docker 容器默认共享宿主机网络时，
curl出去的 IP 是宿主机出口 IP；但若用了bridge模式且未配置端口映射，容器内curl可能走不通外网——这时应检查容器网络策略，而不是改 PHP 代码去“猜”IP - 某些云厂商（如阿里云 ECS）提供元数据服务（
http://100.100.100.200/latest/meta-data/public-ipv4），比公网 HTTP 接口更稳定，但仅限该平台，不可移植
真实环境里，出口 IP 不是“查一下就能有”的固定值，它受网络架构、代理、CDN、防火墙多重影响。写死逻辑或过度简化解析，往往比不查还危险。
