17370845950

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() 在某些容器或精简系统中可能返回空或不可解析名，此时需配合系统命令兜底。

更健壮的做法：遍历本地网络接口（推荐用于生产）

用 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 只会埋坑。