PHP中获取本机网卡IP不能依赖$_SERVER，应使用gethostbyname(gethostname())或net_get_interfaces()遍历接口并过滤回环/无效地址。
PHP 里用 $_SERVER 获取的“IP”大概率不是服务器本机 IP，而是客户端 IP 或代理转发后的 IP —— 想拿本机（网卡）IP，不能靠 $_SERVER。
为什么 $_SERVER['SERVER_ADDR'] 不总是本机真实 IP
它返回的是当前请求所绑定的服务器 IP，但受以下情况影响：
- Web 服务监听在
0.0.0.0或*时，$_SERVER['SERVER_ADDR']可能是0.0.0.0（无效值） - 容器环境（Docker/K8s）中，它常返回容器内部虚拟 IP（如
172.17.0.2），而非宿主机网卡地址 - 反向代理（Nginx/Apache）或云负载均衡后，
$_SERVER系列变量反映的是代理链路中的某一层，和物理网卡无关
获取本机网卡 IP 的可靠方法：用 gethostbyname() + gethostname()
这是最轻量、跨平台（Linux/macOS/Windows）、不依赖扩展的方式：
$hostname = gethostname();
$ip = gethostbyname($hostname);
// 如果返回的是 127.0.0.1，说明 hostname 解析到了 localhost，需 fallback
if ($ip === '127.0.0.1' || $ip === '::1') {
$ip = '127.0.0.1';
// 尝试读取 /etc/hosts 或调用 ifconfig/ip 命令（仅 Linux）
if (stripos(PHP_OS, 'Linux') !== false) {
$ips = array_filter(array_map('trim', explode("\n", shell_exec('hostname -I 2>/dev/null'))));
$ip = !empty($ips) ? current($ips) : $ip;
}
}
注意：gethostname() 在某些容器或精简系统中可能返回空或不可解析名，此时需配合系统命令兜底。
立即学习“PHP免费学习笔记（深入）”；
更健壮的做法：遍历本地网络接口（推荐用于生产）
用 net_get_interfaces()（PHP 7.2+ 内置函数）直接读网卡配置：
$interfaces = net_get_interfaces();
foreach ($interfaces as $name => $iface) {
if (!empty($iface['unicast'])) {
foreach ($iface['unicast'] as $addr) {
$ip = $addr['address'];
// 跳过本地回环、IPv6 链路本地等非业务 IP
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) &&
!in_array($ip, ['127.0.0.1', '0.0.0.0']) &&
!str_starts_with($ip, '169.254.')) {
echo $ip; // 找到第一个可用 IPv4 网卡 IP
break 2;
}
}
}
}
这个方法绕开了 DNS 和 hostname 配置问题，直取内核网络栈数据，准确性高。但要注意：net_get_interfaces() 在 Windows 上支持有限，部分旧版 PHP 可能未启用该函数（需确认 phpinfo() 中是否列出）。
真正难的不是“怎么写一行代码”，而是判断你到底要哪个 IP：是监听端口绑定的地址？是默认路由出口的地址？还是某张特定网卡的地址？不同场景下答案完全不同，硬套 $_SERVER 只会埋坑。
