gethostbyname() 在多网卡下返回 127.0.0.1 或错误 IP，因其仅依赖 hosts 文件和 DNS 解析主机名，不感知实际网卡状态；应改用 net_get_interfaces() 遍历启用的非回环 IPv4 接口，但容器中该 IP 是内网地址，非宿主机出口 IP。
gethostbyname() 在多网卡下为什么总是返回 127.0.0.1 或错误 IP
因为 gethostbyname(gethostname()) 依赖系统 hosts 文件和 DNS 解析逻辑，不查网卡，只查主机名映射。多数 Linux 发行版默认把 localhost 或主机名映射到 127.0.0.1，Windows 同理；即使改了 hosts，也只反映静态配置，无法感知实际启用的网卡和分配的 IP。
用 net_get_interfaces() 遍历网卡（PHP 7.2+ 原生支持）
这是最可靠的方式：直接读取系统网络接口状态，过滤掉回环、未启用、无 IPv4 地址的接口。
-
net_get_interfaces()返回关联数组，键为网卡名（如eth0、enp0s3、wlan0），值含unicast（IPv4/IPv6 列表）、flags（含up表示已启用） - 需手动遍历每个接口，检查
$iface['flags']是否含up，再找$addr['address']且$addr['family'] === 'inet' - 跳过
lo（回环）和所有以127.开头的地址
$interfaces = net_get_interfaces();
$ip = null;
foreach ($interfaces as $name => $iface) {
if ($name === 'lo' || !in_array('up', $iface['flags'])) continue;
foreach ($iface['unicast'] ?? [] as $addr) {
if ($addr['family'] === 'inet' && !str_starts_with($addr['address'], '127.')) {
$ip = $addr['address'];
break 2;
}
}
}
echo $ip ?: 'no usable ipv4 found';
PHP
没有 net_get_interfaces() 时，只能调用系统命令解析输出，但要注意平台差异和权限问题。
- Linux 下可用
ip -4 addr show（推荐）或ifconfig（部分新发行版已弃用） -
macOS 用
ifconfig，注意接口名习惯是en0、en1 - Windows 用
ipconfig，输出格式混乱，建议加/all并 grepIPv4 - 务必用
escapeshellcmd()处理命令，避免注入；且 Web 服务器用户（如 www-data）需有执行权限
示例（Linux）：
立即学习“PHP免费学习笔记（深入）”；
$output = [];
exec('ip -4 addr show | grep "inet " | grep -v "127.0.0.1" | head -n1 | awk \'{print $2}\' | cut -d"/" -f1 2>/dev/null', $output);
$ip = $output[0] ?? null;
别忽略 Docker / 容器环境下的“本机 IP”语义混淆
在容器中运行 PHP 时，net_get_interfaces() 返回的是容器网络命名空间的接口（如 eth0 的 IP 是容器内网 IP，不是宿主机物理网卡 IP）。如果目标是宿主机对外服务的真实出口 IP，这类方法全都不适用——得靠上层调度器传入（如通过环境变量 HOST_IP）或由反向代理（Nginx、Traefik）在请求头中透传（如 X-Real-IP）。
也就是说，“取本机 IP”这个动作本身，在容器、云函数、NAT 后部署等场景里，根本就不是一个有唯一答案的问题：你真正要的，是哪个上下文里的“本机”？
