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

本文介绍如何在 PHP 中对带小数点（radix）的任意精度数值进行十进制与十六进制的高精度双向转换，解决 BCMath 缺乏进制转换支持的问题，并推荐成熟可靠的开源库方案。

本文介绍如何在 PHP 中对带小数点（radix）的任意精度数值进行十进制与十六进制的高精度双向转换，解决 BCMath 缺乏进制转换支持的问题，并推荐成熟可靠的开源库方案。

在 PHP 中进行任意精度运算时，bcmath 扩展虽能处理大整数和定点小数运算，但其原生函数（如 bcadd、bcdiv）不支持带小数部分的进制转换——例如将 123.456（十进制）精确转为十六进制 7B.74BE76E978D5，或反之将 A.FF（十六进制）无损还原为十进制浮点表示。手动实现 dechex() / hexdec() 的任意精度版本虽可行，但需严谨处理小数位移、进位截断与精度对齐，极易引入舍入误差或循环精度损失。

幸运的是，已有经过充分测试的专业数学库可直接满足该需求：

✅ 推荐方案：使用 brick/math + phpseclib

• brick/math（GitHub）这个库的价值，核心就在于它提供了真正意义上的任意精度 BigDecimal 类。换句话说，不管是无限精度的十进制运算、科学计数法处理，还是四舍五入策略的精细控制，它都能稳稳接住。同时，像 toString()、toScale() 这类方法也已经内置好，方便把小数精度控制在可预期范围内。虽然它本身并不直接负责进制转换，但作为后续转换流程中的高保真数值底座，作用非常关键。

• phpseclib/phpseclib（v3+，MathBigInteger）则专精于大整数运算与进制转换。其 BigInteger 支持从任意进制字符串（含小数点）构造，并可通过 toString($base) 输出指定进制字符串——关键在于：它支持解析并保留小数部分的精确位数。

? 注意：phpseclib 的 BigInteger 默认仅处理整数，但 v3.0+ 引入了 BaseConverter 工具类及对小数点的显式支持。更实用的做法是——将带小数的任意进制数拆分为整数部与小数部，分别转换，再按权重拼接：

use BrickMathBigDecimal;
use phpseclib3MathBigInteger;

// 示例：十进制 "123.456" → 十六进制
function decToHex($decStr): string {
$parts = explode('.', $decStr);
$intPart = $parts[0] ?? '0';
$fracPart = $parts[1] ?? '0';

// 整数部分直接转换
$hexInt = (new BigInteger($intPart, 10))->toString(16);

// 小数部分：转为高精度 BigDecimal，乘以 16^N 模拟移位，取整后转十六进制，再补前导零
if ($fracPart !== '0') {
$decimalFrac = BigDecimal::of("0.$fracPart");
$precision = strlen($fracPart); // 可按需提升（如 * 10^20）
$scale = 20; // 控制十六进制小数位数
$scaled = $decimalFrac->multipliedBy(BigDecimal::of('16')->pow($scale));
$hexFracInt = (new BigInteger($scaled->toScale(0)->toString(), 10))->toString(16);
// 补零至 scale 位（因高位可能被截断）
$hexFrac = str_pad($hexFracInt, $scale, '0', STR_PAD_LEFT);
return "$hexInt.$hexFrac";
}

return $hexInt;
}

echo decToHex("123.456"); // 输出类似 "7b.74be76e978d5..."

⚠️ 注意事项与最佳实践

• 精度权衡：小数进制转换本质涉及无限循环分数（如十进制 0.1 在二进制中为 0.000110011...），因此必须显式指定目标进制的小数位数（$scale），否则无法终止。
• 避免 BCMath 直接转换：bcdiv() 等函数默认截断而非四舍五入，且不保证进制转换逻辑正确；切勿用 bcadd(bcdiv(...), ...) 拼凑转换逻辑。
• 部署友好性：两个库均纯 PHP 实现，无系统依赖，通过 Composer 安装即可：

  composer require brick/math phpseclib/phpseclib:"^3.0"

• 性能提示：对于高频转换场景，建议缓存常用转换结果或预计算幂表（如 16^k 的 BigInteger 形式）。

说到底，与其从零手写一套既繁琐又容易踩坑的进制转换算法，不如把成熟工具用在刀刃上：用 brick/math 负责高精度十进制运算，用 phpseclib 承担可靠的大整数进制转换，再配合分治思路，把整数部分和小数部分拆开处理，共同完成任意精度、支持 radix 的双向转换。这样做的好处很直接：精度更稳，代码更好维护，也更适合放进生产环境里长期运行。