PHP获取本机IP的正确方法

本文深入剖析了PHP中准确获取服务器本机网卡IP的常见误区与可靠方案，明确指出依赖$_SERVER变量（如SERVER_ADDR）极易返回代理IP、容器虚拟IP或无效地址（如0.0.0.0、127.0.0.1），根本无法代表真实物理网卡IP；文章重点推荐两种跨平台、高鲁棒性的替代方法：一是轻量级的gethostbyname(gethostname())配合系统命令兜底，二是更精准、直取内核网络接口信息的net_get_interfaces()遍历过滤法，并强调真正关键的是根据实际场景（如监听绑定、默认路由出口或指定网卡）厘清“本机IP”的确切含义——选错方法，轻则日志失真、监控失效，重则服务发现异常、集群通信故障。

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

本篇关于《PHP获取本机IP的正确方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！