PHP Transliterator 怎样取得转换器的逆向规则

PHP 的 Transliterator::createInverse() 用来从已有转换器取得逆向转换器。它返回的不是转换后的字符串，而是一个新的 Transliterator 对象；成功时可以继续交给 transliterate()，失败时返回 null。因此，稳妥的写法是先创建正向规则，再检查逆向对象，最后执行转换。

这类需求常见于“输入先规范化、输出时恢复另一种表示”的代码，但要先记住：逆向规则只表达转换方向，不保证原始信息一定能够无损找回。

先分清逆向转换器和逆向结果

createInverse() 没有参数，调用对象就是规则来源。它的返回类型是 ?Transliterator：成功得到一个转换器对象，失败得到 null。真正处理文本的动作仍然是 transliterate()。

可以把它拆成两个独立对象来理解：

• 正向对象保存原始规则，例如 Any-Latin。
• 逆向对象保存与正向规则相反的转换方向。
• 字符串只有在调用 transliterate() 时才真正被处理。

先创建一个可用的 Transliterator

下面用 Any-Latin 创建规则，并在创建失败时直接抛出异常。示例中的注释说明了每个 API 的职责，便于把这段逻辑放进服务代码。

id}\n";

// transliterate() 才会处理字符串；这里保留 false 作为失败信号。
$latin = $forward->transliterate('北京');
if ($latin === false) {
    throw new RuntimeException(
        $forward->getErrorMessage()
    );
}

echo "转换结果：{$latin}\n";
?>

这里有两个容易混淆的返回值：create() 失败时是 null，而 transliterate() 失败时是 false。不要用一个宽泛的真假判断替代类型检查，否则排查错误时会丢失发生阶段。

调用 createInverse() 取得逆向规则

得到正向对象后，直接调用无参方法即可。建议把返回值保存到单独变量，先判断对象是否存在，再读取 id 或执行逆向转换。

createInverse();
if ($inverse === null) {
    throw new RuntimeException(
        sprintf(
            '无法创建逆向规则，code=%d，message=%s',
            $forward->getErrorCode(),
            $forward->getErrorMessage()
        )
    );
}

// 逆向对象独立存在，后续文本处理仍然通过 transliterate() 完成。
echo "逆向规则：{$inverse->id}\n";
$back = $inverse->transliterate($latin);
if ($back === false) {
    throw new RuntimeException($inverse->getErrorMessage());
}

echo "逆向结果：{$back}\n";
?>

对象创建和文本转换分开后，日志可以明确回答两个问题：规则有没有创建成功，以及这条规则处理某段文本时有没有失败。

为什么要检查 null 和错误状态

官方方法签名明确把返回类型写成可空的 Transliterator。如果直接写 $forward->createInverse()->transliterate(...)，一旦 ICU 无法构造逆向规则，就会把“规则创建失败”变成后续的空对象调用错误。

更适合复用的做法是把这一步封装成返回对象的方法，在边界位置统一抛出包含错误码和错误信息的异常：

createInverse();
    if ($inverse === null) {
        throw new RuntimeException(sprintf(
            'createInverse failed: code=%d, message=%s',
            $forward->getErrorCode(),
            $forward->getErrorMessage()
        ));
    }

    return $inverse;
}

// 调用方只接收可用对象，避免在业务代码里重复判断 null。
$inverse = inverseOf($forward);
$result = $inverse->transliterate($latin);
if ($result === false) {
    throw new RuntimeException($inverse->getErrorMessage());
}
?>

逆向规则不等于无损还原

“逆向”描述的是规则的方向，不是数据库意义上的回滚。一个转写规则可能把多个不同字符映射到相同的拉丁表达，或者在规范化时丢掉大小写、重音和标点信息。此时再调用逆向转换器，只能按 ICU 的逆向规则生成一个可能的表示，不能承诺恢复唯一原文。

小结

PHP Transliterator 取得逆向规则的核心代码就是 $inverse = $forward->createInverse()。成功后把对象交给 transliterate()，失败时检查 getErrorCode() 与 getErrorMessage()。最后要把规则方向和无损还原分开看：如果业务必须恢复原文，仍需保存原始数据或建立明确映射。

相关问题

createInverse() 需要传入方向参数吗？

不需要。它是实例方法，没有参数，方向来自当前 Transliterator 对象的规则。

为什么 createInverse() 返回 null？

表示 ICU 没有成功构造逆向转换器。应在同一对象上读取 getErrorCode() 和 getErrorMessage()，不要直接对返回值继续调用方法。

逆向转换后能百分之百得到原文吗？

不能保证。是否可逆取决于规则是否丢失信息；需要可靠恢复时，请额外保存原文或使用显式可逆编码。