PHP CLI 下无法用 $_SERVER 获取本机 IP，因这些变量仅 Web SAPI 中有效；gethostbyname(gethostname()) 不可靠，依赖 hosts/DNS，常返回 127.0.0.1 或失败；推荐用 ip/ipconfig 命令提取活跃非回环 IPv4 地址，或 socket 连接 8.8.8.8 后 socket_getsockname 反查，但需外网连通；无“唯一正确”本机 IP，应依用途（监听、URL、日志）选择适配方案。
PHP CLI 模式下无法直接用 $_SERVER['SERVER_ADDR'] 或 $_SERVER['REMOTE_ADDR'] 获取本机 IP，因为这些变量只在 Web SAPI（如 Apache、FPM）中填充。
为什么 gethostbyname(gethostname()) 不可靠？
它依赖系统 hosts 文件和 DNS 解析，常返回 127.0.0.1 或解析失败（尤其在无网络/离线环境）。gethostname() 返回的是主机名，不等于本机实际对外 IP。
- Linux 下若
/etc/hosts把主机名映射到127.0.0.1，结果就是127.0.0.1 - Windows 可能因 NetBIOS 或 WSL 环境返回虚拟网卡地址
- 容器或云服务器中，主机名常不指向真实业务网卡
推荐：用 netstat 或 ip 命令 + exec() 提取活跃 IPv4 地址
CLI 环境可调用系统命令，比纯 PHP 函数更准确。优先匹配「UP」状态且非 loopback 的 IPv4 地址：
function getLocalIP() {
if (PHP_OS_FAMILY === 'Linux') {
$output = [];
exec("ip -4 addr show | grep -E '^[0-9]|inet ' | grep -v '127.0.0.1' | head -n 1", $output);
if (!empty($output)) {
foreach ($output as $line) {
if (preg_match('/inet (\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})\//', $line, $m)) {
return $m[1];
}
}
}
} elseif (PHP_OS_FAMILY === 'Windows') {
$output = [];
exec('ipconfig | findstr "IPv4"', $output);
if (!empty($output)) {
foreach ($output as $line) {
if (preg_match('/IPv4 Address[.\s]*: ([\d.]+)/', $line, $m)) {
return trim($m[1]);
}
}
}
}
return '127.0.0.1';
}
- 避免用
ifconfig（macOS 已弃用，Linux 部分发行版默认不装） - 不依赖 DNS，只读取内核网络栈当前配置
- 跳过
127.0.0.1和::1，但不保证是“公网可访问 IP”——仅表示本机某张网卡的 IPv4 地址
如果必须纯 PHP 实现，用 socket_create 连接外部地址反查出口 IP
本质是让系统选一条路由，再查该 socket 绑定的本地地址。注意：需有外网连通性，且不能保证是业务监听 IP（比如多网卡时可能选错）：
立即学习“PHP免费学习笔记（深入）”；
$socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP); socket_connect($socket, '8.8.8.8', 53); // 不真发包，只触发路由选择 socket_getsockname($socket, $addr); socket_close($socket); echo $addr; // 如 '192.168.1.100'
- 连接
8.8.8.8是为了触发默认路由，不发送实际数据 - 某些防火墙或严格策略下可能失败（如 UDP 被拦截），此时应 fallback 到命令行方案
- 不要用
127.0.0.1或本地服务地址做目标，否则得不到真实出口 IP
真正要注意的是：没有“唯一正确”的本机 IP —— 多网卡、Docker bridge、k8s CNI、NAT 后的宿主机，都会让“本机 IP”含义模糊。先明确你要这个 IP 干什么：bind() 监听？生成回调 URL？日志标记？不同场景该选的地址来源完全不同。
