PHP不支持真正的WebSocket客户端多线程并发，因其原生为同步阻塞模型；正确方案是采用Amp或ReactPHP等异步库（如amphp/websocket-client），或Swoole协程客户端（如swooletw/websocket-client），配合异步DNS、TLS配置及连接池管理。
PHP 本身不支持 WebSocket 客户端多线程连接
PHP 的 fsockopen、stream_socket_client 或基于它们的库（如 ratchet/pawl、textalk/websocket）都运行在单线程同步模型下。即使你用 pcntl_fork 模拟多进程，每个子进程仍是单连接、阻塞式收发 —— 这不是“多线程 WebSocket 客户端”，只是多个独立的单连接实例。
常见错误现象：stream_set_blocking($socket, false) 后调用 stream_select 手动轮询，但一旦连接数上升，CPU 占用飙升、超时堆积、消息乱序；或直接抛出 Warning: stream_socket_client(): unable to connect to ... (Connection refused)，本质是底层 socket 资源耗尽或服务端限流。
- PHP CLI 模式下无法真正并发处理多个 WebSocket 连接的读写（无原生 async/await 或 event loop 驱动）
-
ext-event或ext-uv可提供事件驱动能力，但需手动管理连接生命周期，且客户端库支持极弱 - 试图用
pthread扩展（已废弃）或parallel扩展启动多线程 WebSocket 客户端，大概率触发 segfault 或连接复用冲突
推荐方案：用 ReactPHP 或 Amp 实现异步并发连接
真正解决 PHP WebSocket 并发问题，必须脱离同步阻塞模型。ReactPHP 是最成熟的选择：clue/reactphp-buzz 不适用 WebSocket，但 ringcentral/psr7 + textalk/websocket 也不行 —— 正确组合是 react/http + react/socket + 自研 WebSocket 握手 + react/stream 处理帧。
更现实的做法是直接使用封装好的异步 WebSocket 客户端：textalk/websocket 不支持异步，应换为 webonyx/graphql-php？不对 —— 正确依赖是：amphp/websocket-client（Amp 生态）或 reactphp/websocket-client（ReactPHP 官方维护）。
立即学习“PHP免费学习笔记（深入）”；
-
amphp/websocket-client支持并发连接、自动重连、Promise 风格 API，底层基于amphp/byte-stream和amphp/socket - 示例关键代码：
use Amp\Loop; use Amp\WebSocket\Client; Loop::run(function () { $client = yield Client::connect('wss://echo.websocket.org'); yield $client->send('hello'); $message = yield $client->receive(); echo $message->getData(); }); - 注意：必须用
composer require amphp/websocket-client amphp/amp，且运行环境需支持ext-curl或ext-openssl（TLS 握手必需）
为什么不要用 Swoole 直接 new WebSocket\Client？
Swoole\Coroutine\Http\Client 支持 WebSocket 协议升级，但它的 upgrade() 方法仅适用于 HTTP 客户端模式，不是标准 WebSocket 客户端实现。直接调用 new Swoole\WebSocket\Client 会报错：Fatal error: Uncaught Error: Class 'Swoole\WebSocket\Client' not found —— 因为 Swoole 4.8+ 已移除该类，只保留服务端 Swoole\WebSocket\Server。
如果你已在用 Swoole，正确路径是：Swoole\Coroutine\Http\Client + 手动处理 WebSocket 帧（RFC 6455），或改用社区维护的 swooletw/websocket-client（基于协程，非多线程）。
-
swooletw/websocket-client底层调用Swoole\Coroutine\Http\Client，支持并发连接池、心跳保活、断线重连 - 它不依赖
pcntl或pthread，所有连接都在一个进程内以协程方式调度，内存开销低、延迟可控 - 注意配置项：
max_concurrent控制最大并发连接数，timeout必须设为合理值（如 5.0），否则协程会卡死在 DNS 解析或 TLS 握手阶段
绕不开的坑：DNS 解析、TLS 握手与连接复用
无论用 Amp、ReactPHP 还是 Swoole，高并发下第一个崩掉的往往不是 WebSocket 协议层，而是底层网络环节。比如：getaddrinfo() failed: Name or service not known 表明 DNS 查询被阻塞；SSL handshake timed out 说明 TLS 握手未在超时内完成；Too many open files 则是系统级 socket 句柄耗尽。
- DNS 必须异步：Amp 默认用
amphp/dns，ReactPHP 需搭配react/dns，Swoole 则内置协程 DNS 查询（Swoole\Coroutine::dnsLookup） - TLS 配置不能省：
verify_peer => true+cafile路径必须有效，否则自签名证书或中间 CA 缺失会导致静默失败 - 连接不能无限开：每个 WebSocket 连接至少占用 2 个文件描述符（读 + 写），Linux 默认
ulimit -n是 1024，100 个并发连接就逼近上限
真正复杂的点不在“怎么连上”，而在“连上之后如何稳定维持数百个连接并分发消息”。这要求你放弃 PHP 传统请求-响应思维，接受长连接、心跳、重连退避、消息序列化一致性等服务端级问题 —— 它们不会因为换了异步库就自动消失。
