windows下php获取本机ip失败的主因是hosts文件将主机名映射到127.0.0.1,导致gethostbyname(gethostname())返回回环地址;$_server['server_addr']在cli模式无效;多网卡时ipconfig需过滤connected状态并排除私有/回环地址。

gethostbyname(gethostname()) 返回 127.0.0.1 或空
这是 Windows 下 PHP 最常见的本机 IP 获取失败现象。根本原因不是 PHP 函数写错了,而是 gethostname() 返回的主机名在 hosts 文件里被映射到了 127.0.0.1(比如 127.0.0.1 MY-PC)。此时 gethostbyname() 必然解析为本地回环地址。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 用记事本以管理员身份打开
C:\Windows\System32\drivers\etc\hosts,检查是否有当前主机名指向127.0.0.1的行,临时注释掉它再测试 - 运行
cmd执行hostname确认当前主机名,再执行ping -n 1 [该主机名]看实际解析结果 - 不要依赖
gethostbyname(gethostname())获取对外 IP,它只反映 DNS 解析行为,不反映网卡真实地址
$_SERVER['SERVER_ADDR'] 在 CLI 模式下为空或 127.0.0.1
$_SERVER['SERVER_ADDR'] 是 Web 服务器(如 Apache/Nginx)注入的变量,只在 HTTP 请求上下文中有效。CLI 模式下该值未定义或沿用配置默认值(常为 127.0.0.1),不能用于获取本机网卡 IP。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- CLI 脚本中必须换用系统命令或扩展方式获取真实 IP
- 快速验证:在 CLI 中运行
php -r "print_r($_SERVER);",确认SERVER_ADDR是否存在且非空 - 若需跨环境兼容,应先判断运行模式:
php_sapi_name() === 'cli'时跳过所有$_SERVER相关逻辑
用 exec('ipconfig') 解析 IPv4 地址但漏掉多网卡场景
Windows 多网卡(如物理网卡 + VirtualBox Host-Only + WSL2 vEthernet)很常见,ipconfig 输出中可能有多个 IPv4 Address 行,直接取第一行容易拿到虚拟网卡或禁用网卡的地址。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 过滤条件要加状态判断:优先匹配含
Media State . . . . . . . . . . . : Connected的适配器块 - 避免用
strpos($line, 'IPv4 Address')粗暴匹配,改用正则提取并排除169.254.x.x(APIPA)和127.0.0.0/8地址 - 示例片段(需自行补全安全过滤):
$output = shell_exec('ipconfig | findstr "IPv4 Address"');<br>$ips = [];<br>foreach (explode("\n", $output) as $line) {<br> if (preg_match('/IPv4 Address[.\s]+:\s+(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})/', trim($line), $m)) {<br> if (!filter_var($m[1], FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {<br> $ips[] = $m[1];<br> }<br> }<br>}
启用 sockets 扩展后 gethostbyaddr() 反向解析失败
即使 sockets 扩展已启用,gethostbyaddr('192.168.1.100') 仍可能返回原始 IP 字符串而非主机名——这不是 PHP 问题,而是 Windows 缺少反向 DNS(PTR)记录或本地 hosts 未配置对应条目。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 反向解析不是获取本机 IP 的合理路径,仅作调试参考;生产环境不应依赖它
- 若必须使用,先确认该 IP 是否能被本地 DNS 服务器反解:
nslookup 192.168.1.100 - 开发机可手动在
hosts文件添加192.168.1.100 mydev.local来让gethostbyaddr()生效
192.168.x.x 段;要绑定监听,就用 0.0.0.0;要日志记录,就取主活动网卡的 IPv4。别指望一个函数通吃。











