thinkphp 本身不运行 websocket 服务，所有“在控制器里 new websocket()”或“curl_init('ws://')”的写法都会失败——这不是配置问题，是协议和生命周期根本冲突。
为什么 curl_init("ws://") 和 new WebSocket() 必然报错
这是最常被复制粘贴却从不生效的两行代码：
-
curl_init("ws://")→ 报Unsupported protocol：cURL 根本不识别ws://协议，只支持http://、https://等 -
new WebSocket()→ 报Class 'WebSocket' not found：PHP 没有原生WebSocket类，这个构造函数只存在于浏览器 JS 环境中 - 用
stream_socket_client("tcp://")手动发字符串 → 浏览器收不到或立刻断连：缺少 HTTP Upgrade 握手、帧头（FIN/MASK/opcode）、掩码校验，协议层面就不合法
php think swoole 启不起来？先查这三处硬性条件
90% 的启动失败不是代码错，而是环境卡死在底层：
- 确认 Swoole 扩展已启用：
php -m | grep swoole，无输出就执行pecl install swoole（推荐 Swoole ≥ 4.8） - 检查端口是否被占：
netstat -tuln | grep 9501；宝塔用户额外确认「安全组」和「防火墙」放行该端口 - 确认 CLI 模式下 opcache 关闭：
opcache.enable_cli=0必须写在php.ini里，否则热更新失效、类找不到
必须用 think-swoole，别碰 think-worker
think-worker（如 topthink/think-worker）只适合 HTTP 长轮询模拟，它无法真正处理 WebSocket 握手与帧解析——TP6 的请求-响应生命周期和 WebSocket 长连接模型天然互斥。
WebSocket 8.18.2
下载
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
- 正确选择：
topthink/think-swoolev4.1+，它把Swoole\WebSocket\Server封装进 TP6 命令生命周期，支持onOpen/onMessage原生事件 + 中间件 + 容器注入 - 配置关键项（
config/swoole.php）：'websocket' => ['enable' => true, 'handler' => \app\listener\WebSocketListener::class] - 自定义 handler 类必须继承
\think\swoole\websocket\Handler或实现对应接口，写成字符串路径且没加use会直接报Class not found
广播消息别遍历 $server->connections，改用 $this->websocket->broadcast()
Swoole 5.x+ 已弃用 $server->connections 属性，TP8.1 + Swoole 4.1 起实际不可靠，硬用会触发 Undefined property: swoole_websocket_server::$connections 错误。
- 推荐方式：
$this->websocket->broadcast($data)—— think-swoole 封装方法，自动跳过当前连接、忽略无效 fd、捕获 push 异常 - 若坚持用原生 API：
foreach ($server->getClientList() as $fd)，但必须配合$server->isEstablished($fd)校验连接有效性 - 广播 JSON 数据时加标志：
json_encode($data, JSON_UNESCAPED_UNICODE)，否则中文变成\uXXXX，前端JSON.parse()失败
真正难的不是写几行 onMessage，而是让连接状态可管、消息路由可控、多 Worker 下的连接列表可共享——这些细节不处理，上线后就是“有时收到、有时收不到”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
