strrev(pack('l', $x)) 可以删了:PHP 8.6 的 pack()/unpack() 支持字节序修饰符
PHP 8.6 为 pack() / unpack() 的整型码 s S l L q Q 和浮点码 f d 增加了 Perl 风格的字节序修饰符:< 表示小端,> 表示大端。规则来自 php.net 的 migration86.new-features、startwithphp.com/php-8.6 以及两份 RFC——「Add pack()/unpack() support for endianness modifiers on integers」(2025-11-21 创建,2026-01-31 更新/接受)与「Add pack()/unpack() endianness modifiers for floating-point numbers」(2026-01-30 创建)。
以前怎么手写
pack('l', $v)、pack('S', $v) 这类码走的是机器字节序。要在协议里写一个固定的大端 32 位长度字段,常见写法是:
// 先按本机顺序打包,再整体翻转(假设机器是小端)
$be = strrev(pack('l', $len));
// 或者自己移位拼字节
$be = chr(($len >> 24) & 0xff)
. chr(($len >> 16) & 0xff)
. chr(($len >> 8) & 0xff)
. chr($len & 0xff);
另一种做法是启动时先探测平台,之后到处带着判断:
$isLittleEndian = pack('S', 1) === "\x01\x00";
这些代码的共同问题是:字节序信息散落在 strrev、位运算和平台判断里,格式串本身看不出这一串是哪种序,复制到别的字段上很容易漏改。
现在怎么写
修饰符直接跟在码后面,格式串自己说明字节序:
echo bin2hex(pack('l>', 1)), PHP_EOL; // 00000001
echo bin2hex(pack('l<', 1)), PHP_EOL; // 01000000
echo bin2hex(pack('f>', 1.5)), PHP_EOL; // 3fc00000
var_dump(unpack('s>value', "\xff\xfe")); // ["value" => int(-2)]
规则可以归成四条:
<小端、>大端,只能跟在整型码s S l L q Q后面;浮点扩展允许f d。- 对本来就固定顺序的码(
v n V N P J)加修饰符会抛ValueError;在g G e E上加也抛ValueError。 f<等价g,f>等价G,d<等价e,d>等价E。- 以前要手写 bit twiddling 或
strrev处理定长字节序,这个需求取消了。
与已有固定字节序码的关系
v(uint16 LE)、n(uint16 BE)、V(uint32 LE)、N(uint32 BE)、P(uint64 LE)、J(uint64 BE)本来就是定序的,写 pack('n>', $x) 属于重复指定,PHP 8.6 直接报 ValueError:
pack('n>', 1); // ValueError
pack('J<', 1); // ValueError
浮点侧同理,g G e E 已经各自绑定了序,不能叠加修饰符。反过来,f< 与 g、f> 与 G、d< 与 e、d> 与 E 完全等价,所以老代码里的 g/G/e/E 不用动;新代码写成 f< / d> 只是把序写得更直白。
几个真实场景
私有二进制协议 / ISO8583 的长度与金额
很多私有协议头是「4 字节大端长度 + 2 字节大端字段数」,金额字段常是「4 或 8 字节大端整数,单位分」。现在可以一整个格式串写完:
$body = '0200' . str_repeat(' ', 60);
$packet = pack('l>', strlen($body)) . pack('S>', 3) . $body;
$h = unpack('l>len/S>cnt', $packet);
var_dump($h['len'], $h['cnt']);
金额写入与读回:
$cents = 123456;
$field = pack('q>', $cents);
var_dump(unpack('q>amount', $field)['amount']); // int(123456)
以前这两行分别是 strrev(pack('l', ...)) / strrev(pack('q', ...)),长度字段和金额字段一旦有一处忘了翻转,抓包看到的就是 36000000 这种值。
WebSocket 帧头的大端长度
WebSocket 帧头的长度分支本来就是固定大端,用 n / J 即可,给它们加修饰符会抛 ValueError:
$payload = str_repeat('a', 200);
$len = strlen($payload);
$head = chr(0x81);
if ($len < 126) {
$head .= chr(0x80 | $len);
} elseif ($len < 65536) {
$head .= chr(0x80 | 126) . pack('n', $len);
} else {
$head .= chr(0x80 | 127) . pack('J', $len);
}
修饰符省事的地方在于 s/S/l/L/q/Q 这些原本跟随机器字节序的码——自建帧头、Redis 风格的二进制长度前缀,直接写 l> 或 q>,不用再借助 strrev 和平台判断。
签名前的字节串拼装
签名前的 canonical string 经常是「时间戳 + 长度 + 正文」的二进制拼接,字节序错一位签名就永远对不上:
$ts = 1735689600;
$body = '{"order":42}';
$canonical = pack('q>', $ts) . pack('S>', strlen($body)) . $body;
$sig = hash_hmac('sha256', $canonical, $secret, true);
格式串 q>、S> 把协议约定直接写在代码里,和文档里的「big-endian int64 / uint16」一一对应。
unpack 的返回值:符号与溢出
unpack() 的结果取决于你用哪个码,同一段字节读出来可能差一个符号位:
var_dump(unpack('s>v', "\xff\xfe")); // int(-2)
var_dump(unpack('S>v', "\xff\xfe")); // int(65534)
var_dump(unpack('l>v', "\xff\xff\xff\xff")); // int(-1)
var_dump(unpack('L>v', "\xff\xff\xff\xff")); // int(4294967295)
小写是有符号、大写是无符号,别混用:协议里明明是无符号计数,用 s> 读会变成负数。Q> 这类 64 位无符号码在超过 PHP_INT_MAX 时 int 装不下,需要精确值就自己拆字节或转字符串处理,不要拿它直接做范围比较。
pack() 侧的方向则是不报错地截断,超出码宽度的值只保留低位:
echo bin2hex(pack('l>', 0x1_0000_0001)), PHP_EOL; // 00000001
PHP 8.6 之前怎么兼容
需要同时跑 8.6 和旧版本的库,用 PHP_VERSION_ID / version_compare 分支,旧分支保留 strrev:
function pack_be32(int $v): string
{
if (PHP_VERSION_ID >= 80600) {
return pack('l>', $v);
}
// 8.6 之前:按本机序打包再翻转,依赖 x86 小端
return strrev(pack('l', $v));
}
// 或者
if (version_compare(PHP_VERSION, '8.6.0', '>=')) {
$head = pack('q>', $ts);
} else {
$head = strrev(pack('q', $ts));
}
strrev 这条路只在机器小端时等价于大端,跨架构部署时不如直接写 pack('N', $v) / 手写移位稳;s/S/q/Q 没有对应的固定序码,旧版本就只能靠 strrev 或位运算兜住。
参考:
- PHP 8.6 migration: new features
- startwithphp.com/php-8.6
- RFC: Add pack()/unpack() support for endianness modifiers on integers(2025-11-21 创建,2026-01-31 更新/接受)
- RFC: Add pack()/unpack() endianness modifiers for floating-point numbers(2026-01-30 创建)