PHP无获取本机IP的内置函数，gethostbyname(gethostname())结果依赖系统配置且常返回127.0.0.1；跨平台需分OS调用命令解析，或根据部署场景选用$_SERVER['SERVER_ADDR']，但无统一解。
PHP 获取本机 IP 的常见函数和实际行为差异
PHP 本身没有“获取本机 IP”的内置函数，gethostbyname(gethostname()) 或 gethostbynamel(gethostname()) 看似可行，但结果高度依赖系统 hosts 配置、DNS 解析顺序和 hostname 解析目标——在 Windows 上常返回 127.0.0.1，Linux 下可能返回内网地址或解析失败。这不是跨平台兼容问题，而是语义误解：PHP 运行时并不知道“本机对外 IP”是什么，它只能查 hostname 对应的首个 A 记录。
用 getifaddrs() 原生方式不跨平台，PHP 扩展也难覆盖
Linux/macOS 支持 getifaddrs() 系统调用获取所有网卡地址，但 Windows 需用 GetAdaptersAddresses()，两者 API 完全不同。PHP 标准库不封装该能力；第三方扩展如 sockets 只提供 socket 层接口，无法直接枚举网卡。想纯 PHP 实现跨平台获取非回环 IPv4 地址，必须自己处理 OS 差异：
- Linux/macOS：执行
ip -4 addr show或ifconfig（需判断命令是否存在）并解析输出 - Windows：执行
ipconfig并匹配IPv4 Address行 - 统一过滤掉
127.0.0.1、::1、空地址、链路本地地址（如169.254.x.x）
$_SERVER['SERVER_ADDR'] 能否替代？要看运行模式
这个值是 Web 服务器绑定监听的 IP 地址，不是 PHP 进程所在机器的任意网卡 IP。它的可靠性取决于部署方式：
- FPM + Nginx：通常正确，前提是 Nginx
listen指定了具体 IP（如listen 192.168.1.10:80），否则可能是0.0.0.0或:: - Apache mod_php：一般可用，但若启用了虚拟主机且
NameVirtualHost配置复杂，可能返回通配地址 - CLI 模式运行 PHP 脚本时：
$_SERVER中无SERVER_ADDR，直接报未定义索引
最稳妥的跨平台方案：优先用 gethostbyname() + 回退到命令行探测
没有银弹，但可分层兜底。以下逻辑在 Windows / Linux / macOS CLI 和 Web 环境均验证可行：
立即学习“PHP免费学习笔记（深入）”；
// 尝试通过 hostname 解析
$ip = gethostbyname(gethostname());
if ($ip !== '127.0.0.1' && filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
return $ip;
}
// 否则执行系统命令（注意权限与安全）
if (PHP_OS_FAMILY === 'Windows') {
$output = shell_exec('ipconfig | findstr "IPv4 Address"');
preg_match('/IPv4 Address[.\s]*?:\s*?(\d+\.\d+\.\d+\.\d+)/i', $output, $m);
} else {
$output = shell_exec('ip -4 addr show 2>/dev/null | grep "inet " | grep -v "127.0.0.1" | head -n1');
preg_match('/inet\s+(\d+\.\d+\.\d+\.\d+)\//', $output, $m);
}
return $m[1] ?? '127.0.0.1';
关键点：必须检查 PHP_OS_FAMILY 而非 PHP_OS；shell_exec 在生产环境常被禁用，得提前确认 disable_functions 配置；正则要容错空格和换行变体。
真正容易被忽略的是：所谓“本机 IP”在容器、云主机、多网卡场景下根本不存在唯一答案——你得先明确要的是管理网段 IP、公网 NAT 出口 IP，还是 Docker bridge 网关，再决定用 curl ifconfig.me 还是读取 /proc/net/route。
