PHP IntlChar 的 digit 与 charDigitValue 怎样处理不同进制

处理 Unicode 字符时，IntlChar::digit() 和 IntlChar::charDigitValue() 看起来都像“把字符变成数字”，但职责并不相同：前者接受 2 到 36 的进制参数，能识别 ASCII/全角字母在高进制中的位值；后者只读取 Unicode 的十进制数字字符，返回的是十进制位值。

官方地址：https://www.php.net/manual/en/class.intlchar.php

需要解析某个进制中的字符，优先用 IntlChar::digit($codepoint, $base)；只想识别 Unicode 十进制数字时才用 charDigitValue()。判断返回值必须使用严格比较，因为数字 0 是合法结果，不能用松散的真假判断代替。

先看触发信号：两个方法到底差在哪

值班时最容易出现的症状是：十六进制的 A 被判成无效，或者阿拉伯数字字符能识别、拉丁字母却没有结果。根因通常不是 Unicode 字符串损坏，而是方法的任务边界选错了。

指定不同进制时，把 digit 当作字符到位值的转换器

digit() 的第二个参数是 radix。范围小于 2 或大于 36 时直接返回 false；字符的数值等于或超过 radix 时同样无效。因此十六进制的 A 是 10，但十进制的 A 不是合法数字。

 36) {
        return null;
    }

    // 这里传入 UTF-8 字符串；返回 false 表示字符不能代表当前进制的一位。
    $value = IntlChar::digit($char, $base);
    if ($value === false) {
        return null;
    }

    return $value;
}

var_dump(readDigit('0', 2));
var_dump(readDigit('A', 16));
var_dump(readDigit('A', 10));
?>

这个例子里，0 会返回整数 0，A 在十六进制中返回 10，在十进制中返回 null。如果业务层用 if (!$value) 判断失败，就会把第一种情况误报为错误。

只读取 Unicode 十进制数字时，用 charDigitValue

charDigitValue() 没有 radix 参数，它面向的是 Unicode 的十进制数字字符。比如 ASCII 的 1、阿拉伯-印度数字和泰文数字都可以得到对应的十进制位值；拉丁字母即使放在“看起来像数字”的输入里，也不会被转换。

如果后续要把多个字符组成十进制整数，可以在这个函数的结果上做累加；不要把 charDigitValue() 当作十六进制或三十六进制解析器，因为它不会为字母提供 10 到 35 的位值。

发布前的快速判断、回滚和告警确认

把字符解析放进接口或批处理前，建议保留三类边界记录：输入字符、base、方法返回值。收到异常时先判断是不是配置边界，再判断是不是字符类别不符合预期。

1. 快速判断：base 不在 2–36 时，直接修复配置；base 合法但 digit() 返回 false 时，检查字符是否超出当前 radix。
2. 结果确认：digit() 用 $value === false，charDigitValue() 同时区分 $value === -1 和 $value === null，不要把 0 当失败。
3. 回滚路径：如果上线后输入协议仍混合了字母和 Unicode 十进制数字，先回退到原有字符串校验，记录原始字符，再单独切换解析方法，避免静默改变订单号或编码字段。
4. 告警确认：把无效字符计数、base 配置错误计数和方法失败计数分开，才能判断是调用方传错进制，还是输入字符集发生变化。

此外，运行环境需要启用 PHP 的 intl 扩展。若部署后出现 Class "IntlChar" not found，先检查扩展安装和加载状态，再处理业务输入；不要用 ASCII-only 的替代逻辑掩盖部署问题。

常见问题

十六进制字符 A 应该调用哪个方法？

调用 IntlChar::digit('A', 16)，因为 digit() 会按指定 radix 把字母映射为 10 到 35 的位值；charDigitValue() 不负责这类转换。

为什么 digit 返回 false，而 charDigitValue 返回 -1？

两者的无效语义不同：digit() 表示字符在指定 radix 中没有可用位值，charDigitValue() 表示它不是 Unicode 十进制数字字符。调用方应按方法分别严格判断。

返回 0 时为什么不能用 if 判断？

0 是有效数字位，在 PHP 中却会被当作假值。使用 === false、=== -1 和 === null 才能保留这个合法结果。

实际选择可以压缩成一句话：有明确进制就用 digit()，只做 Unicode 十进制数字识别就用 charDigitValue()；然后把返回值边界和 intl 扩展状态记录进运行手册。