PHP 中实现任意精度小数的十进制与十六进制双向转换教程

本文介绍如何在 PHP 中对带小数点（radix）的任意精度数值进行十进制与十六进制的高精度双向转换，解决 bcmath 缺乏进制转换能力的问题，并推荐成熟、可部署于共享主机的纯 PHP 解决方案。

本文介绍如何在 PHP 中对带小数点（radix）的任意精度数值进行十进制与十六进制的高精度双向转换，解决 bcmath 缺乏进制转换能力的问题，并推荐成熟、可部署于共享主机的纯 PHP 解决方案。

在 Web 开发里，只要场景碰到金融计算、密码学常量，或者高精度科学数据，标准浮点数（float）和基础整数类型的精度通常就不够用了。PHP 的 bcmath 扩展确实支持任意精度整数/小数的四则运算，但它的原生函数，比如 bcadd、bccomp，并没有提供进制转换能力——而 dechex() 和 hexdec() 又只覆盖内置整型范围，面对超长数字或带小数的数值就无能为力。更麻烦的是，任意精度的带小数点进制转换，必须同时保证整数部分和小数部分都不丢精度。举个最直接的例子，像 123.4567890123456789 这样的十进制数，要把它精确转换成十六进制，或者再从十六进制完整还原回来，难点恰恰就在这里。

幸运的是，无需从零手写“移位+长除法”算法（如用 1024 倍放大再截断二进制位等易出错方案），已有经过生产验证的纯 PHP 库可直接集成：

✅ 推荐方案：BrickMath + phpseclib 组合使用

• BrickMath（GitHub）就是冲着任意精度小数场景来的，提供 BigDecimal 类型，内置 toString()、toScale()、plus()、dividedBy() 等方法，小数点前后都能实现任意精度运算。更省心的是，它完全不依赖扩展和系统命令，用在共享主机部署这类环境里也很合适。

• phpseclib 的 BigInteger（GitHub）提供高鲁棒性的大整数进制转换（toString($base) / setPrecision()），支持 2–36 进制，包括十六进制（base=16）与十进制（base=10），并可精确控制精度位数。

二者协同即可覆盖完整需求：

1. 使用 BrickMathBigDecimal 表示带小数的任意精度值；
2. 将小数部分分离（如 123.456 → 整数 123 + 小数 0.456）；
3. 对整数部分用 phpseclibMathBigInteger::fromBase() 转换进制；
4. 对小数部分采用「缩放→整数转换→反向缩放」策略（如 0.456 × 10^N 转为整数，转换后再除以 10^N，全程用 BigDecimal 运算保精度）。

? 示例代码（十进制字符串 ↔ 十六进制字符串，含小数）

use BrickMathBigDecimal;
use phpseclibMathBigInteger;

// 十进制字符串转十六进制（支持小数）
function decToHex(string $decStr, int $fracPrecision = 10): string {
$parts = explode('.', $decStr);
$intPart = $parts[0] ?? '0';
$fracPart = $parts[1] ?? '0';

// 整数部分转换
$intHex = (new BigInteger($intPart))->toString(16);

// 小数部分：缩放为整数 → 转十六进制 → 反向缩放（用 BigDecimal 控制精度）
if ($fracPart !== '0') {
$scale = 10 ** $fracPrecision;
$scaledFrac = BigDecimal::of($fracPart)->multipliedBy(BigDecimal::of($scale));
$scaledInt = (int) $scaledFrac->toScale(0)->getValue(); // 截断取整（可改用 round）
$fracHex = (new BigInteger((string)$scaledInt))->toString(16);
// 补前导零并截取所需小数位（十六进制下每字符≈4bit，需换算）
$hexFracLen = (int) ceil($fracPrecision * log(10, 16));
$fracHex = str_pad($fracHex, $hexFracLen, '0', STR_PAD_LEFT);
$fracHex = substr($fracHex, 0, $hexFracLen);
return $intHex . '.' . $fracHex;
}

return $intHex;
}

// 使用示例
echo decToHex('10.01', 6); // 输出类似 "a.028f5c"

⚠️ 注意事项：

• 小数进制转换本质是无限逼近过程（如 0.1 十进制在二进制中为循环小数），因此必须显式指定目标精度（$fracPrecision），否则可能陷入无限循环；
• BrickMath 默认使用十进制内部表示，避免二进制浮点误差；phpseclib 的 BigInteger 使用字节数组存储，无长度限制；
• 部署前请通过 Composer 安装：composer require brick/math phpseclib/phpseclib:~3.0；
• 若仅需整数转换，phpseclib 单独即可胜任；若需高频小数运算，优先以 BrickMath 为主引擎，按需调用 BigInteger 转换。

综上，放弃手动实现“移位缩放”算法，转而采用模块化、测试充分的开源库，不仅大幅提升开发效率与结果可靠性，也显著降低维护成本——这才是面向生产环境的任意精度进制转换最佳实践。