PHP十六进制转十进制方法

hexdec()是最直接的十六进制转整型函数，但仅支持小写、无前缀格式；处理带前缀或大小写混用字符串需先用ltrim()和strtolower()清洗，并用ctype_xdigit()验证；超长十六进制（如SHA-256）应使用gmp_init()避免精度丢失。

hexdec() 是最直接的转换函数，但只支持小写和无前缀格式

PHP 内置的 hexdec() 函数专为十六进制字符串转整型设计，但它对输入格式很敏感：只接受纯数字字符（0-9 和 a-f），不接受大写字母、前缀（如 0x 或 #）、空格或任何其他符号。

• ✅ 正确：hexdec("ff") → 255，hexdec("1a2b3c") → 1715004
• ❌ 报错或截断：hexdec("0xFF") 返回 0（遇到 X 就停）；hexdec("FF") 也返回 0（大写不识别）
• ⚠️ 注意：hexdec() 返回的是 float 类型（当值超过 PHP_INT_MAX 时），不是 int —— 这在 32 位系统或处理长哈希时容易出问题

带前缀或大小写混用时，先清理再转

真实场景中，十六进制字符串常来自表单、API 响应或颜色值（如 "#a3cF12"、"0XDEADBEEF"），必须预处理。

• 用 ltrim() 去掉常见前缀：ltrim($hex, "0x#") 或更稳妥地用正则 preg_replace('/^0x|#|^0X/', '', $hex)
• 统一转小写：strtolower() 必不可少，否则 hexdec() 会失败
• 验证是否只剩合法字符：ctype_xdigit() 可判断清洗后字符串是否全为十六进制字符（注意它不接受空字符串）
• 示例：

  $raw = "#A3cF12";
  $clean = strtolower(ltrim($raw, "0x#"));
  if (ctype_xdigit($clean)) {
      $num = hexdec($clean); // → 10735378
  }

超长十六进制（如 SHA-256 哈希）不能用 hexdec()

hexdec() 在值过大时会退化为 float，精度丢失。比如 hexdec("ffffffffffffffff") 在 64 位 PHP 上可能还行，但 "deadbeefdeadbeefdeadbeefdeadbeef"（32 字符）必然溢出，结果不可信。

• 替代方案是 gmp_init() + gmp_strval()（需启用 GMP 扩展）：

  $big = gmp_init("deadbeef", 16);
  $num = gmp_strval($big, 10); // 字符串形式的十进制数

• 若无 GMP，可用 base_convert()，但它也有长度限制（内部用 int 运算，仍可能溢出）
• 关键判断点：如果原始字符串长度 > 16（对应 64 位整数上限），就别指望得到精确的 int，老实用字符串或 GMP 处理

从二进制数据（如 pack/unpack）里取整型，别混淆 hex 和 bin

有人看到十六进制字符串，下意识用 pack("H*", $hex) 再 unpack()，这是把“表示十六进制的字符串”误当成“十六进制编码的二进制流”了。

• ❌ 错误思路：unpack("N", pack("H*", "000000ff")) → 试图把字符串 "000000ff" 当作字节序列解析，实际得到的是 0x30 0x30 0x30 0x30 0x30 0x30 0x66 0x66（ASCII 码）
• ✅ 正确做法：先用 hexdec() 或 GMP 转成数值，再按需 pack()；或者用 hex2bin() 把真正以十六进制编码的二进制字符串（如 API 返回的 "a3f1" 表示两个字节 0xa3 0xf1）转出来，再 unpack()
• 一句话区分：hexdec() 解释「字符串内容是十六进制」；hex2bin() 解码「字符串本身是十六进制编码的二进制」

事情说清了就结束。重点不在函数名有多短，而在你手里的那个字符串到底是什么——是人读的十六进制表示，还是机器传的十六进制编码，这点一错，后面全偏。