$_SERVER['SERVER_ADDR'] 返回 fe80::1 是因监听 IPv6 通配符且未绑定 IPv4，属链路本地地址不可外访；gethostbyname(gethostname()) 可优先获 IPv4 地址，但需确保 hosts 正确配置，否则仍可能返回 IPv6；安全 fallback 应过滤无效地址并依环境选择方案。
为什么 $_SERVER['SERVER_ADDR'] 返回 fe80::1 这种地址
这是 IPv6 的链路本地地址（Link-Local Address），常见于 macOS 或启用了 IPv6 的 Linux 系统，当 PHP 服务监听在 [::]（即 IPv6 通配符）且未显式绑定 IPv4 时，$_SERVER['SERVER_ADDR'] 就可能返回 fe80::1。它不能用于外部访问，也不等同于本机可连的 127.0.0.1 或真实局域网 IP。
用 gethostbyname(gethostname()) 获取 IPv4 回环或局域网 IP
这个组合能绕过协议栈自动选择逻辑，优先返回 IPv4 地址：
-
gethostname()拿到机器名（如my-mac.local） -
gethostbyname()查 DNS / hosts，通常解析为127.0.0.1（若 hosts 配置正确）或实际内网 IP（如192.168.1.10） - 注意：如果
/etc/hosts里没把主机名映射到 IPv4，可能仍返回fe80::对应的 IPv6 地址 —— 此时需手动 fallback
安全可靠的 fallback 方案：遍历 netstat -in 或 ip addr 输出
PHP 无法直接跨平台获取「可用的非链路本地 IPv4 地址」，但可通过 shell 命令补足：
- Linux/macOS：
exec('ip -4 addr show | grep "inet " | grep -v "127.0.0.1" | head -n1 | awk \'{print $2}\' | cut -d/ -f1', $out); - Windows：
exec('ipconfig | findstr "IPv4" | findstr -v "127.0.0.1" | head -n1 | awk "{print $NF}"', $out);（需系统有 awk，或改用 PowerShell） - 务必过滤掉
127.0.0.1、0.0.0.0、::1、fe80::、fdxx::等无效地址
phplinklocal 不是 PHP 内置函数，别直接调用
搜索结果里出现的 phplinklocal 是某些老旧博客或私有封装函数名，不是标准函数，也没有统一实现。如果你看到类似代码，大概率是某人自己写的封装，内部逻辑无非就是上面几种方式的组合 —— 直接抄容易漏兼容性判断。真正要用，建议按场景选：开发环境认 127.0.0.1，生产环境读配置或命令行查网卡，别依赖自动探测。
立即学习“PHP免费学习笔记（深入）”；
最常被忽略的一点：Docker 容器里 gethostname() 返回的是容器 ID，ip addr 查到的是容器虚拟网卡 IP，和宿主机完全无关 —— 这时候得靠环境变量传入或服务发现机制，而不是硬写探测逻辑。
