phpEnv默认Nginx不支持WebSocket，因未转发Upgrade和Connection头致400错误；需验证版本≥1.13.13、修改nginx.conf添加proxy_set_header Upgrade $http_upgrade等指令，并调优超时与缓冲参数。
phpEnv 默认的 Nginx 配置不支持 WebSocket，直接用 ws:// 或 wss:// 会卡在握手阶段，返回 400 或连接被重置——这不是 PHP 或前端代码的问题，是 Nginx 没转发 Upgrade 和 Connection 头导致的。
确认 phpEnv 的 Nginx 版本是否达标
WebSocket 反向代理从 Nginx 1.3.13 开始正式支持，而 phpEnv 常见版本（如 phpEnv-5.6、phpEnv-7.4）内置的 Nginx 多为 1.12.x 或 1.14.x，需手动验证：
- 进到 phpEnv 安装目录（如
C:\phpEnv或/opt/phpenv），执行nginx -v - 若输出
nginx version: nginx/1.12.2或更低，必须升级 Nginx —— phpEnv 不提供一键升级，得替换bin/nginx二进制并同步调整conf/nginx.conf路径引用 - 1.14.0+ 一般可用，但建议不低于 1.15.0，避免早期 1.13 分支中
proxy_buffering off对大消息的兼容问题
修改 phpEnv 的 nginx.conf 启用 WebSocket 代理
phpEnv 的主配置通常位于 conf/nginx.conf（Windows）或 etc/nginx/nginx.conf（Linux/macOS），重点改两处：location 块和 upstream（如有）
- 确保
proxy_http_version 1.1已启用（phpEnv 默认已设，但检查别被注释掉） - 在目标 location（比如聊天室路径
/chat/ws）内必须显式添加：proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
- 加长超时时间，否则空闲 60 秒后连接会被 Nginx 断开：
proxy_read_timeout 86400;（24 小时） - 禁用缓冲以保实时性：
proxy_buffering off;；若聊天室有大文件传输（如截图），再补proxy_buffer_size 16k; proxy_busy_buffers_size 32k;
注意 phpEnv 的 Windows 版本特殊限制
Windows 下的 phpEnv 使用的是 MinGW 编译版 Nginx，不支持 epoll，且对长连接的资源回收较弱。实测中容易出现「连接数突增后新 WebSocket 握手失败」，原因不是配置错，而是系统级限制：
立即学习“PHP免费学习笔记（深入）”；
- 默认
worker_connections 512，聊天室并发超 200 人时建议调到1024（改nginx.conf的 events 块） - Windows 系统本身对 TIME_WAIT 连接回收慢，需在注册表中调高
MaxUserPort和降低TcpTimedWaitDelay（非 Nginx 配置项，但直接影响可用连接数） - 不要把
location /全局配成 WebSocket 代理——phpEnv 的 PHP-FPM 是走fastcgi_pass的，混用会导致 .php 请求 502
测试 WebSocket 握手是否真正穿透
别只靠浏览器控制台看 WebSocket connection to ... failed，要分层验证：
- 先 curl 测试 Nginx 是否转发了 Upgrade 头：
curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" http://localhost/chat/ws，响应里必须含HTTP/1.1 101 Switching Protocols - 后端服务（如 Workerman、Swoole）日志里应看到客户端 IP 和完整握手头，而不是
empty upgrade header类报错 - 如果用 wss，phpEnv 自带的 OpenSSL 版本常为 1.0.2，不支持 TLS 1.3，需在 server 块加
ssl_protocols TLSv1.2;，否则 Chrome 会静默拒绝
最易被忽略的是：phpEnv 的 Nginx 配置里，http 块顶部可能有 include vhost/*.conf;，而你的 WebSocket 配置如果写在单独的 vhost 文件里，却没被加载——务必检查 conf/vhost/ 目录是否存在、文件名是否以 .conf 结尾、且内容未被注释。
