CLI 下无法获取 $_SERVER['SERVER_ADDR'] 是因为该变量由 Web 服务器注入，而 CLI 模式无请求上下文；需通过系统命令（如 hostname -I 或 ipconfig）或环境变量获取本机 IP。
CLI 下无法获取 $_SERVER['SERVER_ADDR'] 的原因
PHP 在 CLI 模式下根本不会初始化 $_SERVER 中与 Web 服务器相关的键（如 SERVER_ADDR、REMOTE_ADDR、HTTP_HOST），因为 CLI 不经过 Apache/Nginx，没有「请求上下文」。直接读取会返回 NULL 或触发 Notice: Undefined index。
常见错误写法：echo $_SERVER['SERVER_ADDR']; // CLI 下报错或空
- Web 环境中该值由 Web 服务器（如 Nginx）注入，通常是监听的 IP（如
127.0.0.1或0.0.0.0） - CLI 是独立进程，不绑定端口、不监听网络，所以没有“服务端 IP”的概念
- 想在 CLI 中拿到本机 IP，必须走系统层查询（如调用
gethostbyname(gethostname())或解析/etc/hosts）
gethostbyname(gethostname()) 在不同系统的行为差异
这是最常用的 CLI 获取本机 IP 方式，但结果不稳定——它依赖系统 DNS 配置和 /etc/hosts 映射，不是真正“网卡 IP”。
- Linux 上若
/etc/hosts把主机名映射到127.0.0.1（默认常见），结果就是127.0.0.1，不是真实局域网 IP -
macOS 可能返回
::1（IPv6 回环），需额外过滤 - Windows 上有时会因 NetBIOS 或 hosts 条目顺序返回错误 IP
- 更可靠的做法是遍历网卡：用
ifconfig（Linux/macOS）或ipconfig（Windows）命令 + 正则提取非回环 IPv4
示例（跨平台安全获取）：
$ips = array_filter(array_map('trim', explode("\n", shell_exec('hostname -I 2>/dev/null || ip -4 addr show | grep "inet " | awk \'{print $2}\' | cut -d/ -f1 2>/dev/null'))), function($ip) { return $ip !== "127.0.0.1" && filter_var($ip, FILTER_VALIDATE_IP); });
$local_ip = !empty($ips) ? current($ips) : '127.0.0.1';
Web 环境中 $_SERVER['SERVER_ADDR'] 不等于实际监听 IP 的情况
即使在 Web 下，$_SERVER['SERVER_ADDR'] 也不一定反映真实对外 IP，尤其在反向代理、容器、云环境里。
- Nginx 反代时，PHP-FPM 收到的是 Nginx 所在机器的 loopback 地址（如
127.0.0.1），而非 Nginx 监听的公网 IP - Docker 容器中，若 PHP 运行在单独容器，
SERVER_ADDR是容器内网 IP（如172.18.0.3），不是宿主机或负载均衡器 IP - 某些云函数（如阿里云 FC）或 Serverless 环境，该值可能被屏蔽或固定为内部地址
- 真正需要对外暴露的 IP，应由上层设施（如 Nginx）通过自定义 header（如
X-Real-IP）透传，PHP 侧需信任并读取该 header
统一获取本机可访问 IP 的实用建议
没有银弹方案，得按场景选：
立即学习“PHP免费学习笔记（深入）”；
- 仅调试用（CLI）：用
gethostbyname(gethostname())+ 排除127.0.0.1，够快但不准 - 需真实网卡 IPv4（CLI）：优先用
exec('hostname -I')（Linux）、exec('ipconfig | findstr IPv4')（Windows），再正则提取 - Web 场景下要“服务端对外 IP”：不要信
SERVER_ADDR，改查 Web 服务器配置或运维约定的 header（如$_SERVER['HTTP_X_REAL_IP']），并做白名单校验 - 容器/云环境：直接读取环境变量（如
$_ENV['HOST_IP']）或元数据接口（如http://169.254.169.254），比猜 IP 更可靠
最易被忽略的一点：同一台机器多个网卡（有线+无线+WLAN热点）时，“本机 IP”本身就不唯一；所谓“获取本机 IP”，本质是获取「某张网卡上能被目标通信方路由到的那个地址」——这个语义必须由业务自己定义清楚，代码才能写对。
