PHP IntlChar 怎样枚举指定码点范围的字符名称

先说结论：PHP 要枚举一个 Unicode 码点范围内的字符名称，直接使用 IntlChar::enumCharNames($start, $end, $callback)。它采用“起始值包含、结束值不包含”的半开区间，只把已分配字符交给回调；回调依次收到码点、名称选择器和字符名称。

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

先把范围写成“含头不含尾”

这类任务最容易错在边界。比如从 0x2600 到 0x2610，实际检查的是 U+2600 到 U+260F，一共 16 个候选码点。0x2610 只是停止位置，不会进入回调。

这个定义适合把多个连续区间拼接起来，也方便用 $end - $start 算出扫描窗口大小。需要注意，窗口大小不等于最终行数，因为 PHP 只枚举已分配的 Unicode 字符。

用 enumCharNames 一次枚举并保留三项信息

下面的示例选择太阳、电话等符号所在的小区间。回调中的第二个参数不是字符本身，而是本次使用的名称类型选择器；第三个参数才是名称文本。

这个例子有两个可观察指标：window 表示范围内有多少个候选码点，named 表示实际收到多少次回调。两者不能混用，否则遇到未命名码点时会把“没有名称”误认为“范围没有扫描”。

名称类型决定你拿到哪一套名称

默认的 IntlChar::UNICODE_CHAR_NAME 是现代 Unicode 名称。若任务需要兼容旧资料或检查别名，可以显式传入其他类型。它们不是“翻译成中文”的选项，返回文本仍是 Unicode 数据中的不变字符名称。

用输出条数区分“空结果”和“扫描失败”

如果范围内没有已分配且符合名称类型的字符，回调可能一次都不执行，但 API 仍可能成功。更稳妥的判断顺序是：先看返回值是否为 false，再看计数是否为零，最后再决定是扩大范围、换名称类型还是保留空结果。

边界也要单独处理：当 $start >= $end 时直接跳过调用；当范围来自用户输入时，先把十六进制字符串转换成整数并限制在有效 Unicode 码点范围内。不要把 charName() 的空字符串与 API 失败混为一谈。

实际项目里的选择顺序

• 要遍历一个范围：使用 enumCharNames()，让 ICU 负责枚举。
• 只查一个码点：使用 charName()，并把空字符串当作“没有名称”。
• 要把码点转回字符：使用 IntlChar::chr()，不要把名称当作字符值。
• 要做稳定统计：同时保存 start、end、名称类型和 named，这样才能复现输出口径。

常见问题

enumCharNames 的结束码点会不会被输出？

不会。结束值是排他上界，区间写成 [$start, $end)。如果需要包含某个最后码点，应把结束值写成它再加一。

为什么实际输出数量比 end - start 少？

窗口长度只是候选码点数量，API 只枚举已分配并符合名称选择器的字符，未命名或未分配码点不会产生等量输出。

PHP 8.3 以前如何判断失败？

官方变更说明指出，PHP 8.3 起失败返回 false，此前返回 null。跨版本代码可以使用严格比较并结合运行环境约束记录结果。

回调的第二个参数是字符吗？

不是。第二个参数是名称选择器的数值，第三个参数才是字符名称；要得到字符本身，应使用码点调用 IntlChar::chr()。