swoole 不支持原生 websocket 客户端连接，仅能通过协程 http 客户端手动实现非标准握手；推荐使用 textalk/websocket（简单同步）或 ratchet/pawl（异步 wss），避免自行解析帧。
用 Swoole 连接 WebSocket 服务端？别搞反了
Swoole 本身不是「客户端连接 WebSocket」的工具，而是用来 实现 WebSocket 服务端 或协程 HTTP 客户端的。如果你的目标是让 php 主动去连一个已有的 WebSocket 服务器（比如 wss://echo.websocket.org），SwooleHttpClient 在旧版本中曾支持 WebSocket 升级，但自 Swoole 4.4+ 起已被移除；目前官方不提供原生 WebSocket 客户端能力。
PHP 连 WebSocket 的实际可用方案
真正能稳定发起 WebSocket 连接的 PHP 方案有限，需按场景选：
-
ext-websocket（PECL 扩展）：轻量、纯 C 实现，支持 wss，但安装麻烦，PHP 8.1+ 兼容性需验证 -
ratchet/pawl（基于 reactPHP）：成熟、异步、支持 TLS，但依赖事件循环，不适合同步脚本环境 -
textalk/websocket：同步阻塞式，API 简单，适合 CLI 工具或短时任务，不支持 wss（除非自己套stream_context_create） - 自己用
fsockopen+ 手动实现 WebSocket 握手和帧解析：可行但极易出错，不推荐
Swoole 唯一合理的“连接”场景：用协程 HTTP 客户端发 Upgrade 请求
如果你坚持用 Swoole，并且目标 WebSocket 服务允许非标准握手（如某些 iot 设备），可以绕过 WebSocket 协议栈，用 SwooleCoroutineHttpClient 发起带 Upgrade: websocket 头的请求，再手动处理帧。但这要求你完全理解 RFC 6455：
$client = new SwooleCoroutineHttpClient('echo.websocket.org', 80); $client->setHeaders(['Upgrade' => 'websocket', 'Connection' => 'Upgrade']); $client->upgrade('/'); // 后续需自己解析掩码、opcode、payload length...这种写法跳过了协议校验，容易因 mask key 错误、分帧逻辑不对导致收不到数据或连接被断开。
立即学习“PHP免费学习笔记（深入）”；
选型关键点：别为“高性能”选错方向
WebSocket 客户端在 PHP 中通常不是性能瓶颈，而是可靠性与维护成本问题：
- 如果只是偶尔发几条消息（如通知推送），用
textalk/websocket最省心 - 如果需要长连接 + 心跳 + 自动重连 + wss，
ratchet/pawl是更稳妥的选择 - 如果已在用 Swoole 构建服务端，并想让 Worker 主动推数据给外部 WS 服务，建议改用 HTTP 回调或 MQTT 等更易控的协议，而非硬上 WebSocket 客户端
真正容易被忽略的是 TLS 验证、代理支持、超时控制和二进制帧处理——这些在多数轻量库中要么默认关闭，要么文档极简，上线前务必实测 wss 场景下的证书错误、网络中断恢复行为。