open_length_check本质是Swoole按配置自动读取包头长度字段并精准截取包体：需严格匹配package_length_type字节序、package_length_offset起始位和package_body_offset包体偏移，三者共同定义二进制布局，非预设协议模式。
open_length_check 本质是让 Swoole 自动切包，不是“选协议”，而是配对字段位置和解释方式
启用 open_length_check 后，Swoole 不再按 TCP 流盲目收数据，而是先读固定长度的包头，从中提取出「真实包体长度」，再继续读够这个长度。它不关心你协议里叫 type/uid/cmd，只认三个配置项：从哪读长度、长度字段多大、包体从哪开始。所谓“几种长度协议”，其实是这三项组合出来的不同二进制布局，不是预设的几种模式。
package_length_type 决定长度字段怎么解码，必须和客户端 pack 一致
这个参数告诉 Swoole：包头里那个“长度值”是用什么字节序和位宽存的。常见取值有：
-
'N'：32 位无符号大端（即pack('N', $len)），最常用，跨平台兼容好 -
'V'：32 位无符号小端（pack('V', $len)），Windows 系统或某些嵌入式设备可能用 -
'n'：16 位无符号大端，适合短消息场景（最大 65535 字节） -
'v'：16 位无符号小端 -
'C'：单字节（0–255），仅用于极简协议，基本不推荐
如果客户端用 pack('V', 1024) 写长度，服务端却配 'N'，就会把 1024 解成完全错误的数（比如 262144），导致后续读取错位或直接丢包。
package_length_offset 和 package_body_offset 是偏移量，不是长度
这两个值容易被误解为“包头长度”，其实它们是字节位置索引（从 0 开始）：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
package_length_offset：长度字段在包头里的起始字节位置。例如包头是type(4)+uid(4)+len(4)+serid(4)，那 len 在第 8 字节起，就填8 -
package_body_offset：整个包体（不含包头）从第几个字节开始。如果包头共 16 字节，就填16；如果长度字段本身包含在包头内且长度值表示的是「包体长度」，那它一定等于包头总长
典型错误是把 package_body_offset 当成“包头长度”去减，结果填成 package_length_offset + 4 —— 这只在长度字段紧挨着包头末尾时才碰巧对，其他布局必错。
package_max_length 是安全阀，不是建议值
这个配置真正在起作用的场景是防攻击或防误写：
- 当解析出的长度值超过
package_max_length，Swoole 会立即关闭连接，不给后续读取机会 - 它不参与分包逻辑，只是兜底；设太小（如 1024）会导致合法大包被断连；设太大（如 100MB）可能耗尽内存
- 生产环境建议略大于业务中最大可能消息体（比如最大 JSON 报文 2MB，则设
3000000）
真正容易被忽略的是：一旦开启 open_length_check，所有连接都强制走这套解析流程。如果某类客户端没按约定发包头（比如发了纯文本），它根本不会触发 onReceive，而是静默等待或超时断开——你得靠日志或抓包确认是不是协议没对齐，而不是怀疑回调没注册。
