phpenv本身不处理IPv6监听，PHP内置服务器需显式指定[::]:端口启用IPv6监听，且依赖PHP编译时启用IPv6支持及系统防火墙放行；旧版本PHP（如7.2）可能不支持[::]写法。
phpenv 本身不处理网络监听或 IPv6 访问，它只是一个 PHP 版本管理工具，类似 rbenv 或 pyenv，只负责切换本地安装的 PHP 可执行文件路径。你用 phpenv 启动的 php -S 内置服务器、CLI 脚本、或配合 Nginx/Apache 使用时，IPv6 支持与否，完全取决于底层 PHP 编译选项和运行时绑定的地址，而不是 phpenv。
php -S 内置服务器如何启用 IPv6 监听
PHP 内置服务器（php -S）默认只监听 127.0.0.1:8000（IPv4 loopback）。要让它响应 IPv6 请求，必须显式指定 IPv6 地址：
-
php -S [::1]:8000 router.php→ 仅监听本地 IPv6 回环（::1） -
php -S [::]:8000 router.php→ 监听所有 IPv6 地址（包括公网接口，需系统允许且防火墙放行）
注意：[::] 是 IPv6 的“未指定地址”，等效于 IPv4 的 0.0.0.0；但 PHP 7.4+ 才稳定支持该写法，旧版本（如 7.2）可能报错 Failed to listen on [::]:8000，此时只能退回到 [::1]。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 浏览器访问
http://[::1]:8000成功，但用服务器公网 IPv6 地址（如https://www.php.cn/link/b9c9d8a1d17fddc2b82ee87f18ac3aed）失败 → 没有绑定[::]，或系统防火墙（ip6tables/nft）拦截了非 loopback 流量 - 启动时报
Could not bind to address [::]:8000→ PHP 编译时未启用 IPv6 支持，或端口被占用
验证 PHP 是否编译了 IPv6 支持：
php -r "var_dump(getprotobyname('ipv6'));"输出非 false 即表示协议栈可用；更直接的是：
php -m | grep -i sockets
确保 sockets 扩展已启用（它是 IPv6 socket 操作的基础）。
phpenv 切换版本后 IPv6 行为是否变化
会，但仅当不同 PHP 版本编译参数不同时：
- 若你用
phpenv安装的某个 PHP 版本（如通过php-build）在 configure 阶段没加--enable-ipv6（较老脚本默认不加），那它的php -S和fsockopen()等函数对 IPv6 地址的解析/连接会失败 - 新版
php-build（2024 年后）默认启用 IPv6，但手动编译时仍可能遗漏
检查当前 PHP 是否支持 IPv6 socket 创建：
php -r "\$s = stream_socket_server('tcp://[::]:0', \$errno, \$errstr); var_dump(\$s !== false);"返回 bool(true) 才算真正可用。
关键点：
-
phpenv global 8.2.10不自动开启 IPv6 —— 它只改$PATH，后续行为由该版本 PHP 二进制决定 - 如果你从源码编译 PHP，务必确认 configure 日志里有
checking for IPv6 support... yes - macOS 上某些 Homebrew 安装的 PHP 可能因
libressl替代openssl导致 IPv6 DNS 解析异常（gethostbyname()返回空），这不是phpenv的问题，但容易误判
本地开发中让其他设备通过 IPv6 访问 php -S
这需要三者同时满足：
- PHP 进程监听
[::]:8000（而非127.0.0.1或[::1]） - 服务器操作系统已启用 IPv6 且分配了全局单播地址（
ip -6 addr show中有2xxx::/64类地址，非fe80::/10） - 主机防火墙放行对应端口的 IPv6 INPUT 链（例如
sudo ip6tables -I INPUT -p tcp --dport 8000 -j ACCEPT）
典型失败场景：
- 用
ifconfig或ip a只看到fe80::/10地址 → 没有公网 IPv6，路由器/NIC 未分配，php -S [::]:8000虽能启动，但外部无法路由到 - Mac 用户用
php -S [::]:8000后，iPhone 同一局域网下仍连不上 → macOS 默认防火墙阻止了非 loopback 的 IPv6 连接，需在「系统设置 > 网络 > 防火墙 > 防火墙选项」中勾选「允许远程登录」或临时关闭防火墙测试 - Linux 服务器上
php -S [::]:8000启动成功，但curl -g 'https://www.php.cn/link/b9c9d8a1d17fddc2b82ee87f18ac3aed'超时 → 检查sysctl net.ipv6.conf.all.forwarding是否为 1（仅转发需要），重点看net.ipv6.conf.all.disable_ipv6 = 0和防火墙规则
实际配置中，最容易被忽略的是：php -S 监听 [::] 之后，你得用真实 IPv6 地址访问，而不是靠 DNS 或 hosts 映射一个域名再指望它自动走 IPv6。很多本地测试卡在这里——以为配了 127.0.0.1 myapp.test 就能用 <a href="https://www.php.cn/link/0bcf683639659c5dc6a46851754bb8f6">https://www.php.cn/link/0bcf683639659c5dc6a46851754bb8f6</a> 触发 IPv6，其实不会。必须显式用方括号格式访问，例如 <a href="https://www.php.cn/link/b9c9d8a1d17fddc2b82ee87f18ac3aed">https://www.php.cn/link/b9c9d8a1d17fddc2b82ee87f18ac3aed</a>。
