PHP获取本机IP为空主因是误用$_SERVER客户端变量；推荐gethostbyname(gethostname())跨平台获取，但容器中可能返回127.0.0.1；Linux可用exec('hostname -I')；需区分监听/绑定/出口地址场景。
PHP 获取本机 IP（即服务器自身网卡绑定的内网或公网 IP）时返回空，通常是因为误用了 $_SERVER 中的客户端相关变量（如 $_SERVER['REMOTE_ADDR'] 或 $_SERVER['HTTP_X_FORWARDED_FOR']），它们反映的是请求来源 IP，不是服务器本机 IP。
用 gethostbyname() + gethostname() 获取本机主网卡 IP
这是最轻量、跨平台（Linux/macOS/Windows）且不依赖外部命令的方式：
-
gethostname()返回当前机器的主机名（如web-server-01） -
gethostbyname( gethostname() )尝试解析该主机名到 IPv4 地址，一般对应系统默认网卡的 IPv4 - 注意：若
/etc/hosts中主机名映射为127.0.0.1（常见于 Docker 容器或开发环境），结果就是127.0.0.1，需进一步处理 - 该方法不支持 IPv6；如需 IPv6，改用
gethostbynamel()并遍历结果筛选inet6地址
示例：
$ip = gethostbyname(gethostname());
if ($ip === '127.0.0.1' || $ip === '::1') {
// 回退到更主动的探测方式
}
用 exec('ip route') 或 exec('hostname -I')（Linux 专用）
当 gethostbyname() 不可靠（比如容器中主机名未正确解析），可调用系统命令直接查路由表或接口 IP：
立即学习“PHP免费学习笔记（深入）”；
-
hostname -I输出所有 IPv4 地址（空格分隔），简单直接，但仅限 Linux -
ip route | awk '/default/ { print $3 }'获取默认网关所在网卡的 IP（即“出向”IP），更贴近业务需要 - 必须确保 PHP 进程有执行权限（
disable_functions未禁用exec等函数） - 注意命令输出可能含换行或空格，需
trim()和explode()处理
示例（取第一个非回环 IPv4）：
$ips = explode(' ', trim(exec('hostname -I')));
$serverIp = '';
foreach ($ips as $ip) {
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) && $ip !== '127.0.0.1') {
$serverIp = $ip;
break;
}
}
检查 $_SERVER 变量是否被代理污染
如果你本意是获取「客户端真实 IP」却误以为是「本机 IP」，那空值往往源于反向代理（Nginx/Apache）未透传头信息：
-
$_SERVER['REMOTE_ADDR']是 TCP 连接发起方 IP，在 Nginx 后面永远是 Nginx 的 IP（如127.0.0.1） - 要拿到真实客户端 IP，需 Nginx 配置
proxy_set_header X-Real-IP $remote_addr;，再读$_SERVER['HTTP_X_REAL_IP'] - 切勿无条件信任
HTTP_X_FORWARDED_FOR，它易被伪造；只在可信内网代理链下使用，并取最左非私有地址 - 私有地址段包括：
10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、127.0.0.0/8等
Docker/Kubernetes 环境下特别注意
容器内 gethostname() 返回的是 container ID，/etc/hosts 默认只映射到 127.0.0.1，导致所有基于主机名的解析都失败：
- 不要依赖主机名解析，改用
exec('hostname -i')（Docker 默认支持）或注入宿主机 IP 为环境变量（如HOST_IP） - K8s 中可用 Downward API 注入 Pod IP：
fieldRef: fieldPath: status.podIP - 若容器使用
hostNetwork: true，则hostname -I可直接返回宿主机 IP
真正容易被忽略的是：没有区分「监听地址」「绑定地址」「路由出口地址」——你想要的 IP，得先明确是给谁看、走哪条路。否则无论怎么查，都只是在修一个错位的假设。
