Nginx代理WebSocket需手动配置：必须设置proxy_http_version 1.1、透传Upgrade和Connection头、延长proxy_read_timeout至86400、禁用proxy_buffering，并确保后端PHP服务已监听对应端口且php_sockets.dll已启用。
phpEnv 本身不内置 WebSocket 服务，它只是 Windows 下的 PHP + Nginx 集成环境；要让基于 phpEnv 的聊天室（比如用 PHP 实现的 WebSocket 服务）能被外部通过 ws:// 或 wss:// 正常访问，关键不是改 phpEnv 界面选项，而是手动编辑其托管的 Nginx 配置文件，补全 WebSocket 反向代理必需的头透传与长连接参数。
确认后端 PHP WebSocket 服务已就绪
phpEnv 不提供开箱即用的 WebSocket 服务器。如果你用的是 PHP 原生 socket（如 socket_create()），需先确保：
- 对应 PHP 版本的
php_sockets.dll已在php.ini中启用（去掉分号），且重启了 phpEnv 的 PHP 服务 - WebSocket 服务进程（例如
start.php）已在后台运行，监听本地端口（如127.0.0.1:8080） - 浏览器或客户端能直连
ws://127.0.0.1:8080成功握手——这是前置验证，Nginx 代理失败时，先排除后端问题
修改 phpEnv 托管的 nginx.conf 文件
phpEnv 的 Nginx 配置路径通常为：C:\phpEnv\nginx\conf\nginx.conf（具体以你安装目录为准）。不要用 phpEnv 图形界面“重载配置”，直接编辑该文件，在 http{...} 块内添加或修改 server 块：
若想用域名或端口暴露 WebSocket（比如 ws://chat.local:8081）：
立即学习“PHP免费学习笔记（深入）”；
server {
listen 8081;
server_name chat.local;
<pre class='brush:php;toolbar:false;'>location / {
proxy_pass http://127.0.0.1:8080; # 指向你的 PHP WebSocket 服务
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_buffering off;
proxy_read_timeout 86400;
proxy_send_timeout 86400;
}}
注意：proxy_pass 后必须是 http:// 协议地址，即使后端是纯 socket —— Nginx 只支持 HTTP 协议反向代理，PHP 进程需自行处理 WebSocket 握手逻辑。
常见失败现象与排查点
配置后仍连不上？优先检查这些：
-
Connection refused：后端 PHP 服务根本没运行，或监听地址/端口与proxy_pass不一致 -
Error during WebSocket handshake: Unexpected response code: 400：Nginx 未透传Upgrade和Connection头，或proxy_http_version未设为1.1 - 连接几秒后自动断开：
proxy_read_timeout过小（默认 60s），WebSocket 心跳间隔超过该值就会被 Nginx 主动关闭 - 消息延迟或粘包：漏掉
proxy_buffering off;，Nginx 缓存了帧数据 - phpEnv 界面显示 Nginx 启动失败：配置语法错误，用命令行执行
nginx -t -c C:\phpEnv\nginx\conf\nginx.conf查具体报错行
WSS（加密 WebSocket）需要额外证书和监听配置
如果前端要用 wss://，不能只靠 phpEnv 自带的 HTTP 服务。你必须：
- 准备合法 SSL 证书（或用 mkcert 生成本地信任证书），放在如
C:\phpEnv\nginx\ssl\下 - 在
server块中启用 HTTPS 监听，并指定证书路径：
server {
listen 443 ssl;
server_name chat.local;
ssl_certificate ssl/chat.local.crt;
ssl_certificate_key ssl/chat.local.key;
<pre class='brush:php;toolbar:false;'>location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_buffering off;
proxy_read_timeout 86400;
proxy_send_timeout 86400;
}}
此时客户端应使用 wss://chat.local 连接，Nginx 负责 TLS 解密后转为普通 HTTP 请求发给后端 PHP 服务 —— 后端代码完全不用感知 SSL。
真正容易被忽略的是：phpEnv 的 Nginx 默认不监听 443 端口，也不加载 SSL 模块（虽多数版本已内置），务必确认 nginx -V 2>&1 | findstr "http_ssl" 输出含 http_ssl_module，否则会启动失败。
