phpEnv配置Nginx支持Websocket转发 phpEnv聊天室配置-php教程-PHP中文网

Nginx代理WebSocket需手动配置：必须设置proxy_http_version 1.1、透传Upgrade和Connection头、延长proxy_read_timeout至86400、禁用proxy_buffering，并确保后端PHP服务已监听对应端口且php_sockets.dll已启用。

phpenv配置nginx支持websocket转发 phpenv聊天室配置

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）：

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 握手逻辑。

Nginx Hosting

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

下载

常见失败现象与排查点

配置后仍连不上？优先检查这些：

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，否则会启动失败。