PHP本身不处理HTTP/2协议层,所谓“启用HTTP/2”实为两件事:一是Nginx监听443 ssl http2并配置有效SSL证书以提供HTTP/2服务端支持;二是PHP通过cURL(需libcurl编译含nghttp2且启用ALPN)发起https请求并显式设置CURLOPT_HTTP_VERSION为CURL_HTTP_VERSION_2_0以实现客户端HTTP/2支持。

PHP 本身不处理 HTTP/2 协议层,所谓“在 PHP 中启用 HTTP/2”实际是两件事:一是让 Nginx 对外提供 HTTP/2(服务端支持),二是让 PHP 发起的出站请求(如 curl)能走 HTTP/2(客户端支持)。两者完全独立,不能互相替代。
确认 Nginx 已启用 HTTP/2 并正确监听 HTTPS
Nginx 必须监听 443 ssl http2,且证书有效,否则浏览器和客户端根本不会协商 HTTP/2。HTTP/2 over cleartext(h2c)在主流环境(包括 Chrome、Firefox、curl 默认行为)中已被禁用,只认 HTTPS + ALPN。
-
listen 443 ssl http2;这行必须出现在 server 块中,http2是关键词,不是可选参数 - 检查 Nginx 是否编译了
--with-http_v2_module:nginx -V 2>&1 | grep -o with-http_v2_module,无输出即不支持 - SSL 配置必须完整:
ssl_certificate和ssl_certificate_key路径要真实存在且权限正确(Nginx worker 可读) - 别漏掉
ssl_protocols TLSv1.2 TLSv1.3;,旧协议会干扰 ALPN 协商
PHP-FPM 与 Nginx 的通信跟 HTTP/2 无关
fastcgi_pass 走的是 FastCGI 协议,它运行在 TCP 或 Unix socket 上,完全独立于 HTTP 版本。Nginx 把用户发来的 HTTP/2 请求解包后,再以 FastCGI 格式转发给 PHP-FPM;PHP 返回的内容,再由 Nginx 封装成 HTTP/2 响应发回去。中间这层 FastCGI 不涉及任何 HTTP/2 概念。
- 常见错误:以为改了
fastcgi_pass就能“开启 HTTP/2”,其实它连 HTTP 都不碰 - 502 错误几乎全因
fastcgi_pass地址不匹配或 PHP-FPM 未运行导致,和 HTTP/2 无关 - PHP-FPM 的
listen配置(如unix:/run/php/php8.1-fpm.sock)只需确保 Nginx 有读写权限,无需额外适配 HTTP/2
让 PHP 的 cURL 请求真正走 HTTP/2
这是最容易被误判的一环:写了 CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_2_0 不代表就成功了。底层 libcurl 必须编译时启用了 nghttp2,且运行时能完成 ALPN 协商。
- 先验证支持:
var_dump(curl_version()['features'] & CURL_VERSION_HTTP2);输出非 0 才算真支持 - 必须用
https://协议,http://强制降级到 HTTP/1.1(curl 不报错,静默回退) - 显式设置版本:
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_2_0);,注意常量名是CURL_HTTP_VERSION_2_0,不是CURL_HTTP_VERSION_2 - 加
CURLOPT_VERBOSE => true查看日志,确认输出里有* Using HTTP2和* ALPN, offering h2 - 目标服务器若未开 HTTP/2(比如用
curl -I --http2 https://example.com测试失败),请求也会自动降级
Guzzle 等 HTTP 客户端的 HTTP/2 配置陷阱
Guzzle 7+ 内部默认使用 cURL,所以它能否走 HTTP/2,完全取决于你当前 PHP 环境的 cURL 支持情况。直接设 'http2' => true 不生效,必须透传 cURL 参数。
- 错误写法:
new GuzzleHttp\Client(['http2' => true])—— Guzzle 7 不识别该选项 - 正确写法:通过
curl子数组传参:['curl' => [CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_2_0]] - 若用 Symfony HttpClient,需确保底层驱动是 cURL(不是 curl 则 fallback 到 PHP stream,不支持 HTTP/2)
- 不要依赖框架文档里的“HTTP/2 支持”描述,务必用
CURLOPT_VERBOSE实测协商结果
最常被忽略的点:HTTP/2 服务端配置(Nginx)和客户端配置(cURL)是两条平行线,各自验证、各自调试。很多人调了半天 Nginx 的 http2_push,却没发现自己的 PHP curl_exec() 根本没走 HTTP/2 —— 因为 libcurl 编译时漏了 nghttp2,或者忘了加 CURLOPT_HTTP_VERSION。动手前,先跑通 curl -I --http2 https://yourdomain.com 和 php -r "var_dump(...CURL_VERSION_HTTP2...);" 这两个命令。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











