离线获取本机局域网IP最可靠方法是net_get_interfaces(),直接读取网卡配置;次选gethostbyname(php_uname('n'))需预先配置hosts文件;$_SERVER['SERVER_ADDR']不可靠,依赖Web服务器监听地址而非真实网卡。

PHP 获取本机 IP 地址不需要联网,但「本机 IP」的定义必须明确:是 PHP 进程所在服务器的网卡 IP(如 192.168.1.100),还是客户端访问时暴露的公网 IP(如 203.0.113.45)?前者完全离线可得,后者通常依赖网络环境甚至代理配置。
用 gethostbyname() + php_uname('n') 离线取本机主机名对应 IP
这是最轻量、纯离线的方法,适用于已配置好 /etc/hosts(Linux/macOS)或 C:\Windows\System32\drivers\etc\hosts(Windows)的场景:
-
php_uname('n')返回当前机器的主机名(如myserver.local),不走网络 -
gethostbyname()查本地hosts文件——若该主机名已映射到局域网 IP(如192.168.1.100),就能立刻返回,不发 DNS 请求 - 若
hosts里没配,它会 fallback 到系统 DNS 解析(此时可能出网),所以务必提前配好
示例:
$hostname = php_uname('n');
$ip = gethostbyname($hostname);
// 若 /etc/hosts 含 "myserver.local 192.168.1.100",则 $ip === '192.168.1.100'
遍历 net_get_interfaces()(PHP ≥ 7.2)直接读网卡配置
这是真正意义上的「离线取局域网 IP」——绕过 DNS 和主机名,直读操作系统网络接口数据:
立即学习“PHP免费学习笔记(深入)”;
-
net_get_interfaces()返回所有网卡信息,包括inet(IPv4)、inet6(IPv6)、up(是否启用)等字段 - 过滤掉
lo(loopback)、docker0、veth*等非物理/非业务网卡,再排除127.0.0.0/8、::1等回环地址即可 - 无需任何网络连接,也不依赖
hosts或 DNS;但 Windows 上需注意某些虚拟网卡可能返回空inet
示例(取第一个可用 IPv4):
$interfaces = net_get_interfaces();
foreach ($interfaces as $name => $info) {
if (!$info['up'] || !isset($info['inet'][0])) continue;
$ip = $info['inet'][0];
if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
echo $ip; // 如 '192.168.1.100'
break;
}
}
为什么 $_SERVER['SERVER_ADDR'] 不可靠?
这个值看似最直接,但它反映的是「当前 HTTP 请求所绑定的监听地址」,不是机器真实网卡 IP:
- 如果 Apache/Nginx 配了
Listen 127.0.0.1:80,$_SERVER['SERVER_ADDR']就是127.0.0.1,哪怕机器另有192.168.1.100 - 反向代理(如 Nginx → PHP-FPM)下,它常为
127.0.0.1或 Unix socket 路径,完全丢失真实网卡信息 - CLI 模式运行 PHP 时,
$_SERVER可能不包含该键,直接报undefined index
真正离线取局域网 IP 的关键,是放弃对「请求上下文」的依赖,转而读系统层信息:net_get_interfaces() 最稳,gethostbyname(php_uname('n')) 次之但需维护 hosts。别碰 $_SERVER 里任何带 REMOTE 或 HTTP_ 前缀的变量——它们全和客户端有关,和「本机」无关。











