PHP无法原生启动WebSocket服务器，必须借助Ratchet等库以常驻进程方式运行，需正确配置HttpServer握手、连接管理、Nginx反向代理及错误处理机制。
WebSocket 不是 PHP 原生能直接“启动”的东西
PHP 本身没有内置 WebSocket 服务器运行时，fsockopen 或 stream_socket_server 可以写底层 socket，但没法直接处理 WebSocket 握手、帧解析、心跳、连接管理——这些必须靠库或外部服务。Ratchet 是最常用的纯 PHP 实现，但它依赖事件循环（如 ReactPHP），不是开个 php -S 就能跑的 Web 服务。
常见错误现象：Connection refused、浏览器报 WebSocket connection to 'ws://...' failed，往往是因为你把 Ratchet 脚本当成普通 PHP 脚本用 Apache/Nginx 直接跑了，而它其实是个常驻进程，得单独启动。
- 必须用命令行启动：
php websocket.php，不能通过 HTTP 服务器访问该文件 - Ratchet 依赖
ext-sockets和ext-mbstring，缺一不可；macOS 默认没开 sockets 扩展，php -m | grep sockets得看到输出 - 不要在 shared hosting（如 cPanel）上硬刚 Ratchet——没权限开长连接、没后台进程管理、防火墙通常拦 ws/wss
Ratchet 的 WsServer 和 HttpServer 必须套着用
很多人只写 new WsServer(new MyChat()) 就以为完事了，结果连 HTTP 升级请求都收不到。WebSocket 连接始于一个 HTTP GET 请求带 Upgrade: websocket 头，Ratchet 要求你显式包裹一层 HttpServer 来处理这个握手阶段。
正确链路是：IoServer::factory( new HttpServer( new WsServer( new MyChat() ) ), 8080 )。漏掉 HttpServer，服务根本不会响应 Sec-WebSocket-Key，浏览器就卡在 pending。
立即学习“PHP免费学习笔记（深入）”；
-
MyChat类必须实现MessageComponentInterface，且至少定义onOpen、onMessage、onClose、onError四个方法，少一个会导致连接立即断开 - 端口别选 80/443：本地开发用 8080、8081 即可；上线必须反向代理（Nginx 把
wss://流量转给后端ws://127.0.0.1:8080），否则浏览器会因混合内容或证书问题拒绝连接 -
onMessage接收到的$msg是原始字符串，不是 JSON 自动解码；要解析得自己json_decode($msg, true)，且务必检查返回值是否为null
连接状态和广播逻辑得自己管，Ratchet 不自动维护“房间”
Ratchet 的 $conn 对象只代表单个连接，$this->clients 是个 SplObjectStorage，不是数组。想群发、分房间、踢人，全得手动存取、遍历、过滤——它不提供 joinRoom('chat') 或 broadcastTo('news') 这种语法糖。
典型翻车点：在 onMessage 里直接 foreach ($this->clients as $client) { $client->send($msg); }，结果把自己也收到了，或者某客户端断线后 $client->send() 报 Connection reset by peer 导致整个进程崩溃。
- 发消息前必须 try/catch：
try { $client->send($msg); } catch (\Exception $e) { $this->clients->detach($client); } - 存连接别用简单数组：
$this->clients->attach($conn)是安全的；用array_push存对象引用，后续unset容易漏、遍历时 key 错乱 - 需要房间功能？自己建
private $rooms = [];，结构如['general' => new SplObjectStorage()]，进房时$this->rooms['general']->attach($conn)
HTTPS/WSS 必须走 Nginx 反代，Ratchet 本身不支持 TLS 终止
浏览器强制要求 wss://（而非 ws://）才能在 HTTPS 页面里建立连接。Ratchet 没有内置 SSL 支持，IoServer::factory(..., 443) 启动只会监听明文端口，证书根本用不上。
唯一靠谱方案：Nginx 做 TLS 终止 + WebSocket 代理。配置里必须包含 proxy_http_version 1.1 和 proxy_set_header Upgrade $http_upgrade，漏掉任一字段，升级请求就被降级成普通 HTTP，连接失败。
- Nginx 配置关键段：
location /ws/ { proxy_pass http://127.0.0.1:8080; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } - 前端连 wss 时地址必须带路径匹配，比如 Nginx 配
/ws/，JS 就得写new WebSocket('wss://example.com/ws/')，路径不一致照样 404 - 本地开发调试别折腾自签名证书——先用
ws://localhost:8080确保逻辑通，再上 wss；Chrome 对无效证书的 wss 会直接静默失败，不报错
真正麻烦的从来不是写几行 onMessage，而是连接生命周期管理、异常网络下的状态同步、以及部署时那堆必须对齐的协议头和代理规则。调通第一连之后，多扔两个终端反复断网重连，比写十次广播逻辑更能暴露问题。
