PHP中正确处理64位无符号整数的方法是什么？

阿华AIGC实验室

2026-5-22

处理PHP移植uint64_t加密代码的正确方式

这个问题我之前在移植加密算法的时候也碰到过，确实挺头疼的——PHP对无符号整数的支持一直是个坑，尤其是涉及到位运算和循环移位的加密逻辑。下面是几个经过实践验证的解决方案，你可以根据自己的场景选择：

1. 用GMP扩展实现任意精度无符号整数操作

GMP是PHP自带的（部分环境可能需要手动启用）任意精度数学扩展，完美支持无符号64位整数的所有位运算。它的优势是不用自己造轮子，运算精度有保障，适合大部分加密场景。

举个循环右移的例子（模拟uint64_t的行为）：

// 初始化一个64位无符号整数
$val = gmp_init('1234567890123456789', 10);
$shift_bits = 5;

// 循环右移：先右移，再把移出的位补到左边
$right_shifted = gmp_shift_right($val, $shift_bits);
$carry = gmp_and(gmp_shift_left($val, 64 - $shift_bits), gmp_init('0xFFFFFFFFFFFFFFFF', 16));
$result = gmp_or($right_shifted, $carry);

// 转成十进制字符串输出
echo gmp_strval($result, 10);

所有位运算（与、或、异或）都可以用对应的GMP函数（gmp_and、gmp_or、gmp_xor）实现，完全兼容uint64_t的逻辑。

2. 用二进制字符串模拟uint64_t操作

如果你的环境不能启用GMP扩展，或者需要兼容非常老的PHP版本，可以把uint64_t的值转换成8字节的二进制字符串，手动实现位运算和循环移位。这种方式兼容性拉满，但需要自己处理字节级的操作，代码量会大一些。

比如把一个64位整数转成二进制字符串：

function uint64_to_bin($val) {
    // 处理负数（模拟无符号）
    if ($val < 0) {
        $val = $val + 0x10000000000000000;
    }
    // 按大端或小端字节序生成8字节字符串，和原C代码保持一致
    return pack('J', $val); // 'J'对应64位无符号大端，根据需求换'P'是小端
}

循环移位的话，就需要拆分字节数组，处理移位后的字节进位，再重新拼接成字符串，虽然麻烦但完全可控。

3. PHP 7+ 64位环境下用掩码模拟无符号行为

PHP 7及以上的64位系统支持64位有符号整数，我们可以用0xFFFFFFFFFFFFFFFF作为掩码，把有符号整数的结果转换成对应的无符号值。这种方式不需要扩展，代码简洁，适合只需要兼容现代64位PHP的场景。

比如实现uint64_t的循环左移：

function rotate_left_uint64($val, $shift) {
    $shift = $shift % 64;
    // 左移后截断到64位
    $shifted = ($val << $shift) & 0xFFFFFFFFFFFFFFFF;
    // 计算被移出的位，补到右边
    $carry = ($val >> (64 - $shift)) & ((1 << $shift) - 1);
    return $shifted | $carry;
}

// 测试：比如对0xFFFFFFFFFFFFFFFF循环左移1位，应该得到0xFFFFFFFFFFFFFFFE
echo dechex(rotate_left_uint64(0xFFFFFFFFFFFFFFFF, 1));

注意：这种方式在32位PHP环境下无效，因为32位PHP的整数最大只能到2^31-1，所以如果要兼容32位系统，还是得用前两种方案。