PHP 8 并无获取本机真实网卡 IP 的新函数，需依场景选择方法：CLI 下用系统命令或 socket_gethostbyname() 配合过滤；Web 中客户端 IP 应优先用 $_SERVER['REMOTE_ADDR']，代理环境下按 HTTP_X_REAL_IP 等顺序校验并过滤私有地址。
PHP 8 中获取本机 IP 的常见误区
直接调用 $_SERVER['SERVER_ADDR'] 是最常用做法，但它返回的是 Web 服务器监听的 IP（比如 127.0.0.1 或 0.0.0.0），不是本机真实网卡 IP。PHP 8 并没有新增专门取本机 IP 的函数，所谓“PHP 8 新特性取 IP 法”是误传——关键在于你到底要什么 IP：监听地址、客户端来源、还是本机对外网卡地址？
获取本机真实网卡 IP（非 127.0.0.1）
适用于 CLI 脚本或需要绑定到具体网卡的场景（如启动 socket 服务）。PHP 本身不提供跨平台获取网卡 IP 的内置函数，需依赖系统命令或扩展：
- Linux/macOS 下可用
exec('hostname -I | awk \'{print $1}\'')（注意空格和引号转义） - Windows 下建议用
exec('ipconfig | findstr "IPv4" | findstr -v "127.0.0.1" | head -n 1 | awk "{print $15}"')，但更稳妥是解析gethostbyname(gethostname())——它在多数配置下能返回首个非 loopback 地址 - 若已安装
sockets扩展，可用socket_gethostbyname(gethostname())，但该函数不保证跳过127.0.0.1，需手动过滤
Web 环境中获取客户端真实 IP（防代理伪造）
这不是“本机 IP”，但常被混淆。PHP 8 对 $_SERVER 数组的键名校验更严格（如禁用某些非法头），所以不能盲目信任 $_SERVER['HTTP_X_FORWARDED_FOR']：
- 优先检查
$_SERVER['REMOTE_ADDR']—— 它是 TCP 连接发起方 IP，不可伪造（除非前端有透明代理） - 若确实在 Nginx/Apache 后使用可信反向代理，再按顺序判断：
$_SERVER['HTTP_X_REAL_IP']→$_SERVER['HTTP_X_FORWARDED_FOR']（只取第一个非私有 IP） - PHP 8.1+ 支持
filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)快速排除内网/保留地址
为什么 gethostbyname(gethostname()) 有时返回 127.0.0.1
这跟系统 hosts 配置强相关。Linux/macOS 下检查 /etc/hosts 是否把主机名映射到了 127.0.0.1；Windows 查 C:\Windows\System32\drivers\etc\hosts。修复方法：
立即学习“PHP免费学习笔记（深入）”；
- 临时绕过：用
gethostbyaddr($_SERVER['SERVER_ADDR'])反查，再重新解析（仅当SERVER_ADDR是真实网卡 IP 时有效） - 长期方案：修改 hosts，将主机名指向实际网卡 IP（如
192.168.1.100 myserver.local），并确保 DNS 或本地解析生效 - 注意：PHP 8 默认启用
opcache.validate_root，修改 hosts 后可能需重启 PHP-FPM 或清除 opcache
真正可靠的本机 IP 获取，从来不是靠一个函数，而是结合运行环境、网络拓扑和安全边界做判断。尤其在容器或云主机里，eth0 地址、169.254.169.254 元数据接口、甚至 /proc/net/route 解析，都比寄希望于某个“PHP 8 新函数”更实际。
