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。别指望一个函数通吃。 
