使用 hexdec 函数处理 UUID 或 GUID 有哪些实用技巧？

gitbox 2025-06-11

什么是 hexdec 函数？

hexdec 是 PHP 内置函数，用于将十六进制字符串转换成十进制数字。比如：

<?php
echo hexdec('1a'); // 输出 26
?>

但是需要注意的是，hexdec 只能处理字符串中的数字和十六进制字符（0-9，a-f），如果输入中包含非十六进制字符（例如 UUID 中的短横线 -），就必须先清理字符串。

UUID 转数字的基本处理方法

UUID 通常形如：

550e8400-e29b-41d4-a716-446655440000

我们想要用 hexdec 处理时，先移除中间的短横线：

<?php
$uuid = '550e8400-e29b-41d4-a716-446655440000';
$cleanUuid = str_replace('-', '', $uuid);
echo hexdec($cleanUuid);
?>

注意： 由于 UUID 长度较长（32 个十六进制字符），它的十进制数值可能超出 PHP 整型的范围，导致 hexdec 只能返回部分正确结果。

如何应对超过整型范围的 UUID

PHP 的整数在 64 位系统上最大支持到 64 位长的数字，对于 32 字节的 UUID，直接用 hexdec 转换往往会溢出。解决方案：

使用 BC Math 或 GMP 扩展
这些扩展支持任意长度的数字计算。

<?php
$uuid = '550e8400-e29b-41d4-a716-446655440000';
$cleanUuid = str_replace('-', '', $uuid);

function bcHexDec($hex) {
    $dec = '0';
    $len = strlen($hex);
    for ($i = 0; $i < $len; $i++) {
        $current = hexdec($hex[$i]);
        $dec = bcmul($dec, '16');
        $dec = bcadd($dec, $current);
    }
    return $dec;
}

echo bcHexDec($cleanUuid);
?>

只取 UUID 的部分字段进行转换
例如，只转换 UUID 的前 8 个字符：

<?php
$uuid = '550e8400-e29b-41d4-a716-446655440000';
$part = substr(str_replace('-', '', $uuid), 0, 8);
echo hexdec($part);
?>

这样可以得到一个比较小的数字，用于索引或快速比较。

实用技巧总结

先清理 UUID 中的短横线，确保传给 hexdec 的字符串只包含十六进制字符。
避免用 hexdec 转换过长的 UUID，推荐用 BCMath 或 GMP 实现大数转换。
根据需求，提取 UUID 的一部分进行转换，减小数值范围。
结合数据库索引设计，将 UUID 转换后的数值用于排序和快速查找。

额外提示：用 hexdec 获取 URL 参数中的 UUID

如果你的项目中 URL 带有 UUID 参数，想快速转换为数字处理，可以结合 PHP 的 $_GET：

<?php
if (isset($_GET['uuid'])) {
    $uuid = $_GET['uuid'];
    $cleanUuid = str_replace('-', '', $uuid);
    echo hexdec(substr($cleanUuid, 0, 8)); // 仅转换前8位
}
?>

示例访问：

https://gitbox.net/project/page.php?uuid=550e8400-e29b-41d4-a716-446655440000

hexdec