固定包头协议必须严格配置open_length_check：'open_length_check'=>true、'package_length_type'=>'N'（与pack一致）、'package_length_offset'=>0（长度字段起始偏移）、'package_body_offset'=>4（包体起始位置）、'package_max_length'=>实际最大包长+包头长度，否则会静默丢包。
固定包头协议的 open_length_check 怎么配才不丢数据
固定包头协议依赖二进制长度字段，必须严格对齐字节偏移和类型。常见错误是把 package_length_offset 和 package_body_offset 搞混：前者是长度字段在包头里的起始位置（从 0 开始），后者是整个包头的长度（即包体从第几个字节开始）。比如用 N 表示 4 字节大端整数长度，包头就只有这 4 字节，那么两个值都该设为 0 和 4；若包头前还有 2 字节魔数，那就要设成 package_length_offset => 2、package_body_offset => 6。
容易踩的坑：
-
package_length_type必须和pack()打包时一致，N和n差 2 字节，错一个 recv 就直接截断或超长 -
package_max_length要大于实际最大包体 + 包头长度，否则 Swoole 会静默丢弃超长包，不报错也不触发回调 - 客户端没用
pack()打包长度字段，而是拼了字符串如"4"，会导致 unpack 解出 0 或乱码
行分割协议（EOF）的 open_eof_split 和 open_eof_check 有什么区别
这两个配置常被当成一回事，但行为完全不同：open_eof_check 只做末尾检测，收到的数据末尾不是 package_eof 就缓存等待下一次；而 open_eof_split 是真正按 EOF 切分，只要数据里出现 package_eof 就立即拆成多个包，哪怕它出现在中间 —— 这就是为什么文档强调“数据中不能含 EOF”，否则必然误拆。
典型场景：
- 日志推送、命令行交互类文本协议，用
\n或\r\n分隔，选open_eof_split => true - 兼容旧协议或需宽松容错时，用
open_eof_check => true，自己在onReceive里用explode()或正则再处理 - 如果同时开启两者，Swoole 优先走
open_eof_split的切分逻辑
为什么固定包头比 EOF 更适合二进制传输
EOF 协议本质是字符串匹配，遇到 \x00、\xff 或任意二进制内容都可能撞上 package_eof，导致不可控拆包。固定包头绕过了这个限制，因为长度字段是纯数值，unpack 后直接跳过指定字节数读包体，不依赖内容特征。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
性能与兼容性影响：
- 固定包头解析在 Swoole 底层完成，
onReceive拿到的就是完整包，无需业务层再切分 - EOF 协议在高吞吐下可能因缓存区未及时 flush 导致延迟，尤其当客户端发包间隔短、包小且无规律时
- HTTP/2 或 Protobuf 类场景，必须用固定包头，否则无法保证结构体完整性
客户端和服务端配置必须完全对称吗
不是必须“完全一样”，但关键三项必须一致：package_length_type、package_length_offset、package_body_offset。服务端开了 open_length_check，客户端可以不开——此时客户端 recv() 返回的是原始 TCP 流，需要自己做解包；但服务端若没开，客户端开了也没用，因为服务端根本不会按长度转发完整包。
同步客户端常见误区：
- 以为开了
open_length_check就能自动 recv 完整包，结果recv()还是返回部分数据 —— 实际上必须配合服务端也启用，且双方长度字段定义一致 - 用
swoole_client连非 Swoole 服务（如自研 C 服务器）时，只配客户端参数没用，得确认对方是否真按同样格式发包头 -
package_max_length在客户端只是 recv 缓冲上限，不影响解析逻辑；但在服务端它控制底层缓存区大小，超限直接丢包
最易被忽略的一点：Swoole 的固定包头解析只工作于 TCP 层，UDP 不支持 open_length_check，别在 SWOOLE_SOCK_UDP 上白费功夫。
