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(),这是把“表示十六进制的字符串”误当成“十六进制编码的二进制流”了。
立即学习“PHP免费学习笔记(深入)”;
- ❌ 错误思路:
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()解码「字符串本身是十六进制编码的二进制」
事情说清了就结束。重点不在函数名有多短,而在你手里的那个字符串到底是什么——是人读的十六进制表示,还是机器传的十六进制编码,这点一错,后面全偏。