pack/unpack必须严格匹配字节序（n大端/v小端）和字段顺序，字符串需用a/a占位；input须返回完整包长而非头长，否则解析失败。
pack/unpack 必须匹配字节序和字段顺序
Workerman 不管你传的是文本还是二进制，它只把数据当字节流处理。真正决定协议是否能正确解析的，是你在 encode 和 input/decode 里怎么用 pack 和 unpack。最常踩的坑是：服务端用 N（大端），客户端用了 V（小端），或者字段顺序写反了，结果 unpack 返回的数组键名对不上，$data['id'] 总是 null。
关键点：
-
N表示 4 字节大端整数（网络字节序），适合跨语言通信；V是小端，PHP 内部常用但不推荐用于协议 - 字段顺序必须和
pack的格式字符串严格一致，比如pack('NcSa', $len, $type, $flag, $str)，那unpack就得用'Nlen/ctype/Sflag/a*str' - 字符串不能直接 pack，要用
a*或A*占位，长度由前面的数字字段控制
input 方法要返回完整包长，不是头长
input 函数的作用是告诉 Workerman：“这个 buffer 里最多能切出多长的一个完整包”。它不是解析逻辑，只是长度探测。如果返回值小于等于 0，Workerman 就继续收数据；一旦返回正整数 N，它就会截取前 N 字节交给 decode 处理。
典型错误写法：return 4;（只返回 header 长度）——这会导致 Workerman 每次只取 4 字节，永远等不到 body。
正确做法（以“4 字节包长 + body”为例）：
public static function input($buffer)
{
if (strlen($buffer) 0 && $total_length
<h3>decode 要剥离 header，只返回业务数据</h3>
<p><code>decode</code> 的输入是已经按 <code>input</code> 返回长度切好的完整包（含 header）。它的职责是把 header 解出来、校验、再把有效载荷（body）提取出来，返回给 <code>onMessage</code> 的 <code>$data</code> 参数。</p>
<p>常见疏漏：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/ai/979" title="速创猫AI简历"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680025033086.png" alt="速创猫AI简历" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/ai/979" title="速创猫AI简历" class="overflowclass">速创猫AI简历</a>
<p class="overflowclass">速创猫AI简历是一款用于生成、优化和定制求职简历的 AI 简历工具。</p>
</div>
<a rel="nofollow" href="/ai/979" title="速创猫AI简历" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 忘记用
substr($buffer, 4)去掉 header，导致后续 json_decode 或 unpack 失败 - 没做长度校验，比如
total_length小于 header 长度（4），或超出预设上限（如 1MB），可能引发内存暴涨 - 对非固定结构体（如带变长字符串）没按 header 中的长度字段动态截取，直接硬解会错位
例如 TLV 结构中，若 header 含 name_len 和 value_len，就得先 unpack 出这两个值，再分别 substr 提取对应字段。
encode 要严格按协议拼接，别漏 header
encode 是发包前的最后一道工序。它接收业务层原始数据（比如一个数组），输出符合协议的二进制字符串。最容易忽略的是：header 和 body 必须拼成一个连续字符串，且 header 的值必须真实反映整个包体长度。
错误示例：return pack('N', 4) . $body; —— 这里 pack 的是 4，但实际总长是 4 + strlen($body)，接收方 unpack 出来就会少读。
正确写法：
public static function encode($buffer)
{
$body_length = strlen($buffer);
$total_length = 4 + $body_length;
return pack('N', $total_length) . $buffer;
}
注意：如果你的协议 header 本身也含多个字段（比如 type + length + version），那就得用 pack('CnN', $type, $length, $version) 全部打进去，再拼 body。
二进制协议真正的复杂点不在 pack/unpack 语法，而在于 header 定义是否自洽、边界条件是否全覆盖（超长、截断、非法值）、以及 client/server 端实现是否完全镜像。哪怕只差一个字节序或一个 substr 起始偏移，整个链路就静默失败。调试时优先 dump 出 raw buffer 十六进制，比猜逻辑更可靠。
