phpenv默认nginx不支持http/2,因未编译--with-http_v2_module且openssl版本不足;须确认nginx -v含该模块及openssl≥1.0.2e,再在listen 443 ssl后显式添加http2,并用curl或浏览器network标签页验证h2协议。

PHPEnv 是一套 Windows 下的本地开发环境套件,它默认集成的是较旧版本的 Nginx(常见为 1.16.x 或更低),而 HTTP/2 支持从 nginx 1.9.5 起引入,但必须满足两个硬性前提:编译时启用 --with-http_v2_module,且运行时依赖 OpenSSL ≥ 1.0.2e 并开启 ALPN。PHPEnv 自带的 Nginx 几乎都不满足这两点 —— 所以直接改配置是无效的,会静默降级回 HTTP/1.1。
确认当前 Nginx 是否真支持 HTTP/2
别信“版本够新就一定行”。很多 PHPEnv 版本打包时没加 --with-http_v2_module,即使显示 nginx/1.18.0,nginx -V 输出里也找不到 --with-http_v2_module。
- 打开命令行,进入 PHPEnv 的 nginx 目录(通常是
C:\phpenv\nginx\) - 执行:
nginx -V 2>&1 | findstr "http_v2"(Windows)或nginx -V 2>&1 | grep http_v2(WSL) - 若无任何输出,说明模块未编译进去 —— 后续所有配置都白搭
- 顺带检查 OpenSSL 版本:
nginx -V 2>&1 | findstr "OpenSSL",低于1.0.2e也不行(PHPEnv 常 bundled OpenSSL 1.0.2a 或 1.1.1c,后者虽新但早期 1.1.1c 缺 ALPN 支持)
listen 指令中必须同时带 ssl 和 http2
即使你搞定了编译和 OpenSSL,Nginx 配置里漏掉任一关键项,HTTP/2 也不会激活。最常见错误是只写 listen 443 ssl,忘了加 http2。
- 正确写法(在
server块内):listen 443 ssl http2; -
http2必须紧接在ssl后面,顺序不能颠倒;不支持listen 80 http2;(现代浏览器拒绝明文 HTTP/2) - 确保已配置有效证书路径:
ssl_certificate和ssl_certificate_key指向 PEM 格式文件,且私钥无密码(PHPEnv 不支持交互式解密) - 避免使用
ssl on;—— 这是过时语法,Nginx 1.15+ 已弃用,会导致配置加载失败
Chrome/Firefox 不显示 h2 协议?先关掉 QUIC 和实验性功能
PHPEnv 本地环境跑 HTTPS + HTTP/2 后,浏览器开发者工具 Network 标签页仍显示 h1,大概率不是服务端问题,而是客户端干扰。
- Chrome 地址栏输入
chrome://flags/#quic,把「Experimental QUIC protocol」设为Disabled - 同样关闭
#http2-and-quic-protocol、#enable-web-bundle等网络实验性开关 - 用
curl -I --http2 https://localhost验证(需 curl ≥ 7.47.0 且编译支持 nghttp2);返回头中出现HTTP/2 200才算真正生效 - 注意:PHPEnv 默认监听
127.0.0.1:80或:443,若绑定了localhost但证书 CN 是127.0.0.1,Chrome 会因 SNI 不匹配拒绝 HTTP/2 升级
PHPEnv 的本质是封装好的二进制分发包,它不提供源码重编译入口。想真正用上 HTTP/2,最省事的方式是换用官方预编译版 Nginx(1.21+,带 OpenSSL 1.1.1w),手动替换 nginx.exe 和 conf/nginx.conf,并确认 openssl.dll 版本匹配 —— 否则极易触发 TLS 握手失败或 ALPN 协商静默失败。这点容易被忽略,但恰恰是本地开发环境下 HTTP/2 开启失败的主因。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











