phpEnv配置Nginx支持Websockets协议 phpEnv聊天室环境-php教程-PHP中文网

phpenv默认nginx不支持websocket，因未转发upgrade和connection头致400错误；需验证版本≥1.13.13、修改nginx.conf添加proxy_set_header upgrade $http_upgrade等指令，并调优超时与缓冲参数。

phpenv配置nginx支持websockets协议 phpenv聊天室环境

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（如有）

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

确保 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 握手失败」，原因不是配置错，而是系统级限制：

默认 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 结尾、且内容未被注释。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！