$_SERVER[‘SERVER_ADDR’] 返回 IPv4 映射的 IPv6 地址（如 ::ffff:192.168.1.100）是双栈环境下的正常现象，需手动识别前缀并提取合法 IPv4 段，推荐用 filter_var 配合正则校验，避免误解析或非法 IP 存储。
PHP $_SERVER[‘SERVER_ADDR’] 返回的是 IPv4 映射的 IPv6 地址（如 ::ffff:192.168.1.100）
这是常见现象，尤其在启用 IPv6 的 Nginx/Apache + PHP-FPM 环境中。$_SERVER['SERVER_ADDR'] 或 gethostbyname(gethostname()) 可能返回 IPv4-mapped IPv6 格式（::ffff:a.b.c.d），而非纯 IPv4。这不是错误，而是内核或 socket 层对双栈监听的默认表示方式。
- 本质是 IPv4 地址被封装在 IPv6 地址空间里，用于兼容 IPv6 socket 同时处理 IPv4 连接
- PHP 本身不自动“降级”解析，需手动提取原始 IPv4 段
- 直接用
inet_ntop(inet_pton($ip))不会改变格式，必须识别前缀并截取
用 filter_var() + 正则安全提取 IPv4 部分
最稳妥的做法是先判断是否为 IPv4-mapped IPv6，再提取最后 4 字节转点分十进制。避免用 explode() 或字符串截断，防止误伤真实 IPv6 或异常格式。
- 检查是否匹配
::ffff:x.x.x.x模式：filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)为 true 且含::ffff: - 用正则提取末段：
preg_match('/::ffff:(/d{1,3}/./d{1,3}/./d{1,3}/./d{1,3})/', $ip, $matches) - 再用
filter_var($matches[1], FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)二次校验合法性 - 不推荐
inet_pton()→ 二进制位运算 →inet_ntop()，因为 PHP 对 IPv4-mapped 地址的inet_pton()解析行为在不同版本略有差异
获取本机真实 IPv4 的更可靠替代方案
如果目标只是拿到本机主网卡的 IPv4（非容器/多网卡场景），依赖 $_SERVER 变量不如主动查系统接口。
- Linux 下执行：
exec('hostname -I | awk /'{print $1}/'', $out); $ipv4 = trim($out[0] ?? '')—— 注意权限与命令注入风险，生产环境建议白名单过滤 - 跨平台可读取
/etc/hosts或C:/Windows/System32/drivers/etc/hosts，找 localhost 对应行，但可能不准确（如映射到 127.0.0.1） - 更健壮：用
gethostbynamel(gethostname())获取所有 IP 列表，遍历用filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)找第一个合法 IPv4 —— 但注意该函数在某些共享主机上被禁用
PHP 8.1+ 中 getaddrinfo() 尚未暴露，别指望 stream_socket_get_name() 自动归一化
有同学试过 stream_socket_get_name($socket, true) 或 socket_getpeername()，发现仍可能返回 ::ffff:...。这是因为底层 libc 的 getnameinfo() 默认保留原始地址族格式，PHP 没做额外转换。
立即学习“PHP免费学习笔记（深入）”；
- PHP 目前无内置函数能“强制转回 IPv4”，必须自己解析
- 别用
ip2long()处理 IPv4-mapped 地址 —— 它只接受 IPv4 字符串，传入::ffff:192.168.1.100会返回 false - 如果后续要进数据库或日志，建议统一转成 IPv4 存储，并记录原始地址族信息（如加字段
ip_version），避免将来查问题时混淆
实际处理中最容易忽略的是：没验证提取出的四段数字是否真在 0–255 范围内，导致看似成功却存了非法 IP（比如 ::ffff:999.999.999.999）。正则提取后务必走一遍 FILTER_VALIDATE_IP。