PHP中Java的getLeastSignificantBits()和getMostSignificantBits()等效实现

我之前也碰到过一模一样的需求——把UUID拆成两个64位字段存数据库，正好可以给你分享PHP里的等效实现。核心思路和Python的逻辑一致：先处理UUID字符串，拆分出对应MSB和LSB的十六进制片段，再转成64位数值。下面分两种场景给出具体代码：

方法一：依赖64位PHP环境（推荐，无需额外扩展） #

如果你的PHP运行在64位系统上，直接用hex2bin和unpack就能搞定，这是最直接高效的方式：

function splitUUIDIntoBits(string $uuid): array {
    // 先移除UUID中的连字符，确保是标准32位十六进制字符串
    $cleanUuid = str_replace('-', '', $uuid);
    if (strlen($cleanUuid) !== 32) {
        throw new InvalidArgumentException('输入的UUID格式无效，请确保是标准的36字符UUID');
    }

    // 拆分前16位十六进制（对应MSB的8字节/64位）和后16位（对应LSB）
    $msbHex = substr($cleanUuid, 0, 16);
    $lsbHex = substr($cleanUuid, 16, 16);

    // 将十六进制转为二进制，再按大端无符号64位解析为整数
    $msb = unpack('J', hex2bin($msbHex))[1];
    $lsb = unpack('J', hex2bin($lsbHex))[1];

    return [
        'msb' => $msb,
        'lsb' => $lsb
    ];
}

// 示例使用
$uuid = 'b33ac8a9-ae4f-427a-89c4-1e6b2c1a3d5f';
$bits = splitUUIDIntoBits($uuid);
echo "MSB: {$bits['msb']}\n";
echo "LSB: {$bits['lsb']}\n";

方法二：兼容32位PHP（需GMP扩展） #

如果你的PHP是32位环境，无法直接处理64位整数，可以借助GMP扩展来处理大数值：

function splitUUIDIntoBitsWithGMP(string $uuid): array {
    $cleanUuid = str_replace('-', '', $uuid);
    if (strlen($cleanUuid) !== 32) {
        throw new InvalidArgumentException('输入的UUID格式无效');
    }

    $msbHex = substr($cleanUuid, 0, 16);
    $lsbHex = substr($cleanUuid, 16, 16);

    // 用GMP解析十六进制为大整数，可转成字符串存储到数据库
    $msb = gmp_init($msbHex, 16);
    $lsb = gmp_init($lsbHex, 16);

    // 如果需要字符串形式，用gmp_strval($msb)转换
    return [
        'msb' => $msb,
        'lsb' => $lsb
    ];
}

反向操作：从MSB和LSB还原UUID #

如果之后需要从数据库读取这两个字段还原成原始UUID，用下面的函数即可：

function bitsToUUID($msb, $lsb): string {
    // 处理GMP数值或整数，转成16位十六进制字符串（补前导零）
    if (is_resource($msb) || is_object($msb)) {
        $msbHex = str_pad(gmp_strval($msb, 16), 16, '0', STR_PAD_LEFT);
        $lsbHex = str_pad(gmp_strval($lsb, 16), 16, '0', STR_PAD_LEFT);
    } else {
        $msbHex = str_pad(dechex($msb), 16, '0', STR_PAD_LEFT);
        $lsbHex = str_pad(dechex($lsb), 16, '0', STR_PAD_LEFT);
    }

    $fullHex = $msbHex . $lsbHex;
    // 按UUID格式插入连字符
    return sprintf('%s-%s-%s-%s-%s',
        substr($fullHex, 0, 8),
        substr($fullHex, 8, 4),
        substr($fullHex, 12, 4),
        substr($fullHex, 16, 4),
        substr($fullHex, 20, 12)
    );
}

小提示 #

• 数据库字段建议用BIGINT UNSIGNED（整数存储）或者VARCHAR(20)（字符串存储），确保能容纳64位无符号整数的范围。
• unpack的J格式是PHP 5.6+才支持的，如果你用的是更老版本，建议升级或者改用GMP方法。
• UUID的字节序是大端（网络字节序），上面的代码完全遵循这个标准，和Python的uuid.UUID对象拆分出的MSB/LSB完全一致。

内容的提问来源于stack exchange，提问作者Chad