学习PHP中的信息格式化操做

在国际化组件的学习过程当中，咱们已经接触过了 NumberFormatter 这种数字的格式化操做，它可让咱们将数字转换成标准格式、货币、本地语言等形式。今天咱们来学习的是另外一种专门用于信息格式化的类 MessageFormatter ，它主要是针对字符串的操做。

MessageFormatter 也是遵循的 ICU 规范，底层是 C 中的 ICU 操做，因此和 C 相关代码的使用方式没有太大的区别。

格式化

// 格式化
$fmt = new MessageFormatter("zh_CN", "{0,number,integer} 只猴子在 {1,number,integer} 颗树上，每只树上有 {2,number} 只猴子");
echo $fmt->format([4560, 123, 4560 / 123]), PHP_EOL;
// 4,560 只猴子在 123 颗树上，每只树上有 37.073 只猴子

$fmt = new MessageFormatter("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum");
echo $fmt->format([4560, 123, 4560 / 123]), PHP_EOL;
// 4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum

echo MessageFormatter::formatMessage("zh_CN", "{0,number,integer} 只猴子在 {1,number,integer} 颗树上，每只树上有 {2,number} 只猴子", [4560, 123, 4560 / 123]), PHP_EOL;
// 4,560 只猴子在 123 颗树上，每只树上有 37.073 只猴子

echo MessageFormatter::formatMessage("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum", [4560, 123, 4560 / 123]), PHP_EOL;
// 4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum

看到了吗？相似于 PDO 里预编译操做的占位符。在调用 format() 方法后，就可让这个方法里面的参数来替换占位符的内容。咱们能够指定占位的所使用的参数类型和位置，{参数下标,类型,扩展类型} 这就是这个信息数据格式化的占位符的规则定义。看起来貌似很简单呀，其实它还有更多的功能，咱们将在后面看到。不过须要注意的是，它只支持数字、日期、文本片断类型，文章最后的参考连接中有官方的文档能够查阅。

MessageFormatter::formatMessage() 这个静态方法能够一次性地指定语言、预操做语句以及替换参数，不须要先进行实例化再调用 format() 方法。

反格式化（根据规则获取参数数组）

可以进行格式化，固然咱们也可以根据语句规则来反格式化相关的字符串从而得到对应占位符的参数列表。

// 根据格式化规则反向获取规则参数
$fmt = new MessageFormatter('zh_CN', "{0,number,integer} 只猴子在 {1,number,integer} 颗树上，每只树上有 {2,number} 只猴子");
$res = $fmt->parse("4,560 只猴子在 123 树上，每只树上有 37.073 只猴子");
var_export($res); // false
echo "ERROR: " . $fmt->getErrorMessage() . " (" . $fmt->getErrorCode() . ")\n";
// ERROR: Parsing failed: U_MESSAGE_PARSE_ERROR (6)

$fmt = new MessageFormatter('en_US', "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree");
$res = $fmt->parse("4,560 monkeys on 123 trees make 37.073 monkeys per tree");
var_export($res);
// array (
//     0 => 4560,
//     1 => 123,
//     2 => 37.073,
//   )

$fmt = new MessageFormatter('de', "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum");
$res = $fmt->parse("4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum");
var_export($res);
// array (
//     0 => 4560,
//     1 => 123,
//     2 => 37.073,
//   )

$fmt = MessageFormatter::parseMessage('de', "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum", "4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum");
var_export($fmt);
// array (
//     0 => 4560,
//     1 => 123,
//     2 => 37.073,
//   )

使用实例化后的 parse() 方法或者直接使用静态方法 MessageFormatter::parseMessage() 就可以实现这样的操做。须要注意的是，对于 zh_CN ，也就是中文语言区域设置来讲，这个操做是会出问题的。经过 getErrorMessage() 和 getErrorCode() 就能够看到错误信息以及错误代码，能够看到对于中文来讲，直接返回的错误信息就是解析失败。

设置获取规则

在实例化的对象中，咱们还能够动态地修改规则语句。

// 设置获取规则
$fmt = new MessageFormatter("zh_CN", "{0, number} 猴子在 {1, number} 颗树上");
echo "默认规则: '" . $fmt->getPattern(), PHP_EOL; // 默认规则: '{0, number} 猴子在 {1, number} 颗树上'
echo "格式化结果：" . $fmt->format(array(123, 456)), PHP_EOL; // 格式化结果：123 猴子在 456 颗树上

$fmt->setPattern("{0, number} 颗树上有 {1, number} 猴子");
echo "新规则： '" . $fmt->getPattern(), PHP_EOL; // 新规则： '{0, number} 颗树上有 {1, number} 猴子'
echo "新规则格式化结果： " . $fmt->format(array(123, 456)), PHP_EOL; // 新规则格式化结果： 123 颗树上有 456 猴子

很是简单的两个方法，setPattern() 用于设置当前实例化对应的格式化规则，getPattern() 用于获取查看当前实例化对象的格式化规则。在设置了新规则以后，进行 format() 或者 parse() 时就是按照新的规则语句来执行的了。

格式化完整示例

上面说过，除了数字以外，还能够有日期格式的占位符，咱们就来演示一下。

echo MessageFormatter::formatMessage('zh_CN', '今天是 {3, date, full}，当前时间为 {3, time, ::Hms}, 我要准备开始 {0} 了，今天要和 {2,number,integer} 人见面，还不能忘了要交 {1,number,currency} 元的电费', ['上班', 35.33, 25, new DateTime()]), PHP_EOL;
// 今天是 2020年11月16日星期一，当前时间为 10:09:30, 我要准备开始 上班 了，今天要和 25 人见面，还不能忘了要交 ￥35.33 元的电费

在这段语句中，咱们给定的参数顺序并非按照语句中占位符出现的顺序，这样并无影响，只须要指定对应位置的参数数组下标便可，好比第一个 {3, date, full} 指定的就是参数数组中的第4个元素（从0开始）。date 类型、time 类型都是能够指定的类型，固然咱们也能够指定它们的 日期格式 好比第二个占位符咱们就只显示当前的时分秒信息。

若是是字符串信息，那么只须要一个简单的 {0} 就能够了，字符串不须要太多的类型设置。而数字类型则能够直接格式化为货币等类型，就像咱们以前讲过的 NumberFormatter 中能够指定的那些类型同样。

看完这一个示例是否是就感受到这个 MessageFormatter 的强大之处了？别急，它还有更牛X的能力。

根据参数内容进行复数显示

对于复数来讲，其实中文语法中并无这样的语句，好比说一只猫是 a cat ，两只猫是 two cats 。

echo MessageFormatter::formatMessage('en_US', 'I Have {0, plural, =0{no cat} =1{a cat} other{# cats}}', [0]),PHP_EOL; // I Have no cat
echo MessageFormatter::formatMessage('en_US', 'I Have {0, plural, =0{no cat} =1{a cat} other{# cats}}', [1]),PHP_EOL; // I Have a cat
echo MessageFormatter::formatMessage('en_US', 'I Have {0, plural, =0{no cat} =1{a cat} other{# cats}}', [2]),PHP_EOL; // I Have 2 cats

虽然说参数类型的 plural 是复数的意思，不过其实咱们能够将它看作是一个 switch() 语句的用法。

echo MessageFormatter::formatMessage('zh_CN', '我{0, plural, =0{没有猫} other{有 # 只猫}}', [0]),PHP_EOL; // 我没有猫
echo MessageFormatter::formatMessage('zh_CN', '我{0, plural, =0{没有猫} other{有 # 只猫}}', [1]),PHP_EOL; // 我有 1 只猫
echo MessageFormatter::formatMessage('zh_CN', '我{0, plural, =0{没有猫} other{有 # 只猫}}', [2]),PHP_EOL; // 我有 2 只猫

# 号就是对应的参数值的原内容，这一套语法又让这个 MessageFormatter 类上了一个层次吧，还有呢！咱们先来看看这个问题：

echo MessageFormatter::formatMessage('en_US', 'I Have {0, plural, =0{no cat} =1{a cat} other{# cats}}', [-1]),PHP_EOL; // I Have -1 cats

参数传错了，-1 只猫可不对吧，不要紧，还有别的处理方式解决这个问题。

选择条件规则

// 选择表达式
echo MessageFormatter::formatMessage('en_US', 'I Have {0, choice, 0 #no cats| 1 #one cat | 2 #{0, number} cats}', [-1]),PHP_EOL; // I Have no cats
echo MessageFormatter::formatMessage('en_US', 'I Have {0, choice, 0 #no cats| 1 #one cat | 2 #{0, number} cats}', [0]),PHP_EOL; // I Have no cats
echo MessageFormatter::formatMessage('en_US', 'I Have {0, choice, 0 #no cats| 1 #one cat | 2 #{0, number} cats}', [1]),PHP_EOL; // I Have one cat
echo MessageFormatter::formatMessage('en_US', 'I Have {0, choice, 0 #no cats| 1 #one cat | 2 #{0, number} cats}', [2]),PHP_EOL; // I Have 2 cats
echo MessageFormatter::formatMessage('en_US', 'I Have {0, choice, 0 #no cats| 1 #one cat | 2 #{0, number} cats}', [10]),PHP_EOL; // I Have 10 cats

choice 这个单词就能看出来，这是一个选择相关的语法。后面的参数实际上是一个区间，分别表明 <= 0 | 1 | >=2 的范围内使用哪一个内容。另外，一个占位符规则里面还能够继续套占位符号的。

总结

又大开了一回眼界。文章开头的两部份内容其实并无什么惊喜的地方，毕竟普通的字符串替换都能办到，不过越日后面但是愈来愈精彩啊。固然，它的相关规则语法应该还有更多，只是这些资料很是少，不论是 PHP 官方文档仍是 ICU 的官方文档都没有找到过多的介绍。因此咱们仍是报以学习了解的态度先知道有这么回事，未来发现更有趣的资料后再来分享学习吧，也但愿有使用过的朋友留言一块儿讨论哦！

测试代码：