swoolecoroutinesocket不能直接当普通socket用，因其依赖协程调度器深度介入io，必须在go()或coroutine un()上下文中使用，不支持fpm/cli环境、stream函数、跨协程共享及默认阻塞模式，超时需setoption()显式配置。
为什么 SwooleCoroutineSocket 不能直接当普通 socket 用
它不是对 fsockopen 或 socket_create 的简单封装，而是协程调度器深度介入的 IO 句柄。一旦调用 connect()、send()、recv()，底层会自动注册事件监听，并在阻塞点（如连接未就绪、缓冲区空）触发协程挂起——这要求你必须在 SwooleCoroutine
un() 或 go() 启动的上下文中使用，否则会报错或行为异常。
- 在 FPM/CLI 普通环境中调用
$socket->connect()会直接抛出Fatal error: Uncaught SwooleException: must be called in coroutine -
socket_set_block()和socket_set_nonblock()对它完全无效，它的阻塞/非阻塞状态由协程调度器统一控制 - 不支持
stream_socket_client()那类 stream 封装层函数，传入socket_get_status()会返回空数组
recv() 不带参数时的默认行为容易导致半包
原生 recv() 默认只读取当前内核缓冲区可用字节数，不保证读满指定长度；而 SwooleCoroutineSocket::recv() 若不传 $length，默认只读 65536 字节且不等待完整帧——这对自定义二进制协议（比如 8 字节帧头+变长 payload）极其危险。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 正确做法是显式传入期望长度：
$socket->recv(8)读帧头，再用$socket->recv($payloadLen)读正文 - 若需流式读取（如 HTTP body），应配合
setProtocol()或手动循环recv()+ 判断feof()状态 - 忽略返回值是否为
false或0会导致死循环或逻辑卡住，因为连接关闭时recv()返回0，错误时才返回false
超时控制必须通过 setOption() 而非 stream_set_timeout()
SwooleCoroutineSocket 的超时机制和 PHP stream 完全隔离。用 stream_set_timeout() 设置的值会被忽略，必须用 setOption() 配置底层 socket 选项。
- 连接超时：
$socket->setOption(SOL_SOCKET, SO_SNDTIMEO, ['sec' => 3, 'usec' => 0])（注意：SO_RCVTIMEO/SO_SNDTIMEO 在 Linux 上需整数微秒，Swoole 封装后接受数组格式） - 读写超时实际生效的是
SO_RCVTIMEO和SO_SNDTIMEO，不是SO_TIMEOUT（该常量在 Swoole 中不存在） - HTTP 客户端等高级封装类（如
SwooleCoroutineHttpClient）内部已处理超时，但原生Socket必须手动设，否则默认无限等待
协程间共享 Socket 实例会导致状态混乱
SwooleCoroutineSocket 实例绑定到创建它的协程栈，不能跨协程复用。多个协程同时调用同一个实例的 recv()，会出现读取错乱、数据截断甚至段错误。
- 常见误用：
go(function() use ($socket) { $socket->recv(); }); go(function() use ($socket) { $socket->recv(); });—— 这不是并发读，而是竞争读 - 正确方式：每个协程持有一个独立
Socket实例，或用Channel做串行化访问（如一个协程专责收包，其他协程从Channel消费） - 连接池场景下，务必确保
Socket归还后调用$socket->close()，否则 fd 泄漏，且下次get()可能拿到未清理状态的句柄
