代码 strrev(pack('l', $x)) 可以删了:PHP 8.6 的 pack()/unpack() 支持字节序修饰符

2026-11-17 21:06:53

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 二进制协议 接口对接

推荐文章

程序员茄子在线接单