在Swoole中实现自定义TCP协议解析需绕过默认逻辑，通过固定头+变长体格式（如4字节魔数+2字节长度字段）定义协议，并借助open_length_check配置或手动缓冲区管理处理粘包拆包，确保消息边界准确识别与业务解码稳定执行。
在Swoole中实现自定义TCP协议解析，需绕过默认的HTTP或简单包处理逻辑，直接接管原始字节流的粘包、拆包与业务解码过程——若仍依赖onReceive裸收数据，将无法稳定识别消息边界，导致后续协议字段错位、JSON解析失败或内存越界。
定义协议格式与分隔规则
先明确你的协议结构：固定头+变长体是最常用方案。例如4字节魔数（0x12345678）+2字节长度字段（body长度）+N字节实际负载。魔数用于快速过滤非法连接数据，长度字段决定本次应收取多少字节才算一帧完整消息。
必须确保客户端发送时严格按此格式组包，否则服务端永远无法对齐。Swoole不负责校验协议合法性，只提供字节流通道。
启用open_eof_check或open_length_check
方法一：用内置长度检测（推荐初学者）
在Swoole\Server或Swoole\Coroutine\Server配置中设置：'open_length_check' => true, → 'package_length_type' => 'N', → 'package_length_offset' => 4, → 'package_body_offset' => 6
这表示：从第4字节开始读取4字节作为包总长度（大端无符号int），整个包长度包含头部；第6字节起才是有效载荷起点。注意package_length_offset是长度字段在包内的偏移，不是body偏移——如果头长6字节（魔数4+长度2），那body确实从第6字节开始，但长度字段本身占2字节，位于4～5字节，所以package_length_offset填4，package_body_offset填6。
【package_length_offset和package_body_offset值一旦设错，会导致所有包解析偏移错乱，且无报错提示】
手动实现粘包处理（协程服务器场景）
当协议含魔数校验、版本号、CRC等复杂头字段时，内置检查不够用，必须手写缓冲区管理。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
第一步：为每个连接维护独立的recv_buffer
在onConnect回调中初始化：$server->connections[$fd]['buffer'] = '';
第二步：在onReceive中追加数据并循环解析
接收新数据后拼接到buffer末尾，然后while循环尝试提取完整包：先检查buffer长度是否≥最小头长（如6字节），再读魔数是否匹配，再读长度字段得到预期总包长，最后判断buffer当前长度是否≥该总长。满足则截出完整包，更新buffer为剩余部分，继续下一轮解析。
第三步：提取出的完整包交给业务解码器
例如调用json_decode(substr($packet, 6), true)解析body，或用unpack按格式读取二进制字段。解码失败时记录日志但不要中断循环——可能是客户端发了脏数据，跳过即可。
这一步操作起来很简单，直接把截出的$packet传给解码函数就行。但要注意：不能在解析中途修改$buffer引用，必须用substr($buffer, $pos)安全截取，否则协程切换时可能引发内存错误。
注册自定义协议处理器（Server对象方式）
方法二：使用setProtocol注入完全自定义解析器
创建一个类实现Swoole\Protocol接口，重写input方法：输入是原始字节流，返回值是整数——表示“已消费多少字节”，若返回0表示数据不足，等待下次收包；若返回正值n，则Swoole自动截掉前n字节，剩余部分留在缓冲区。
在input中做魔数校验、长度提取、完整性判断，仅当确认一帧完整时才返回包总长度。返回值必须精确，多1少1都会导致后续所有包偏移崩溃。
【return值必须严格等于当前识别出的完整包字节数，不可四舍五入或估算】
