Workerman 5.2.3 自定义协议向后兼容的关键是在协议层设计而非降级框架；需在input中识别版本分流、decode中按版本分支解包并统一返回PHP数组、encode中按客户端版本输出对应格式，配合灰度迁移与过期机制。
Workerman 5.2.3 自定义协议要兼容旧版客户端，核心不是“降级框架”，而是**在协议层做向后兼容设计**。新版 Workerman 对 ProtocolInterface 的契约没有破坏性变更（input、decode、encode 三个静态方法仍为必需），所以兼容关键在于你自定义协议类的实现逻辑，而非框架版本本身。
协议头加版本标识字段
旧版客户端可能按固定包结构通信（比如前4字节是包体长度，无版本信息）。新版服务端需能识别并分流处理：
- 在
input方法开头，检查缓冲区前若干字节是否符合旧格式（如：是否以 0x00 开头、是否长度字段紧贴开头） - 若匹配旧格式，返回旧协议的完整包长；若检测到新格式（如前2字节为
0xFE 0xFD表示 v2 协议），则按新规则解析 - 建议统一用1字节版本号（如第0位为
0x01是旧版，0x02是新版），后续扩展更可控
decode 方法支持多版本解包
decode 不再假设所有数据都走同一套解析逻辑：
- 根据
input阶段已识别出的版本号，分支调用不同解包函数（如decodeV1()/decodeV2()） - 旧版客户端发来的纯字符串或 JSON 包，可先用
json_decode($buffer, true)尝试解析；新版可能用二进制序列化，就走unpack('Nlen/a*body', $buffer)类逻辑 - 确保两种版本最终都返回结构一致的 PHP 数组（如
['type' => 'msg', 'data' => ...]），避免onMessage回调里重复判断
encode 方法默认输出旧格式，按需切新版
服务端发给旧客户端的数据，必须严格遵循旧协议格式：
- 在
encode中，通过$connection->protocol_version或连接上下文标记（如握手时协商的版本）判断目标客户端能力 - 若为旧客户端，直接打包成旧格式（如：4字节长度 + 原始 JSON 字符串）；若为新客户端，则加入版本头、压缩字段等
- 可在
onConnect里初始化客户端版本标识，例如解析首次握手消息中的client_ver=1.2参数并存入$connection->clientVer = '1.2'
渐进式迁移策略
不强制一刀切升级，降低业务风险：
- 上线前用灰度流量验证：让 5% 新版客户端走新协议，其余走旧协议，观察日志中
input的识别准确率 - 设置协议过期时间：在服务端记录旧协议最后使用时间，3个月后自动拒绝旧格式连接（通过
input返回false关闭） - 客户端 SDK 更新时，增加双协议支持——先尝试新协议握手，失败则回落到旧协议，服务端无需感知切换过程
