必须使用Protocol Buffers二进制格式替代PHP原生序列化，严格统一协议版本与字段编号；通过protoc生成PHP类并依赖google/protobuf扩展；Swoole Server需启用协程及长度校验分包（前4字节为包体长度）；编解码须校验长度头防崩溃，非法包直接关闭连接。
要在Swoole中实现高性能、跨语言兼容的二进制通信，必须绕过PHP原生serialize或JSON，直接对接Protocol Buffers二进制格式，且需确保服务端与客户端在协议版本、字段编号、编码顺序上严格一致。
定义并编译Protobuf协议文件
新建user.proto，声明message结构并指定syntax = "proto3"；注意不要用proto2，Swoole协程环境下proto3对默认值和字段缺失更友好。
执行protoc --php_out=./proto user.proto生成PHP类；这一步必须使用google/protobuf官方PHP扩展（非纯PHP实现），否则序列化性能下降50%以上。
将生成的User.php放入app/Proto目录，并在composer autoload中注册该命名空间。
配置Swoole Server启用协程与二进制处理
创建Swoole\Server实例时，设置['open_eof_split' => true, 'package_eof' => "\n"]——但不能直接用EOF分包，因为Protobuf二进制流不含可识别的结束符。
改用'open_length_check' => true, 'package_length_type' => 'N', 'package_length_offset' => 0, 'package_body_offset' => 4：前4字节为网络字节序的包体长度，这是Protobuf+TCP通信的【强制约定】，客户端也必须按此打包。
启用enable_coroutine => true，否则Protobuf::decode()在高并发下可能阻塞整个Worker进程。
编写协程安全的序列化/反序列化封装
方法一：基于静态工厂构造
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
在App\Codec\ProtobufCodec中定义encode(User $msg): string——先调用$msg->serialize()，再用pack('N', strlen($data)) . $data拼接长度头。
方法二：支持多类型动态解析
反序列化时不能硬编码User::class，需从协议头或上下文提取消息类型ID；在decode(string $raw, string $className)中先substr($raw, 4)截掉长度头，再传给new $className()->mergeFromString($body)。
【关键陷阱】若客户端发来非法长度头（如0xFFFFFFFF），substr会返回空字符串，导致mergeFromString抛出Fatal Error；必须在截取前校验strlen($raw) >= 4 && $len = unpack('N', $raw)[1] > 0 && $len 。
在TCP连接中集成Protobuf收发逻辑
第一步：监听onReceive事件，获取原始$fd和$data
第二步：调用ProtobufCodec::decode($data)尝试解析；失败则立即$server->close($fd)，不响应、不重试——Protobuf格式错误代表协议层崩溃，不是业务异常。
第三步：成功解包后，根据$msg->getType()路由到对应Handler，例如AuthHandler::process($msg)。
第四步：Handler返回结果对象（如LoginResponse），用ProtobufCodec::encode($response)序列化，再通过$server->send($fd, $packed)发出。
