Yii2如何将纯数字手机号格式化为易读掩码文本？

刚好之前碰过一模一样的需求，Yii2本身就带了现成的工具，完全不用自己写正则或者重复造轮子！给你两种最实用的方案：

方案一：直接用Yii2内置Formatter组件（推荐） #

Yii2的Formatter组件专门用来处理各种数据格式的展示，手机号格式化正好是它的拿手好戏。

只需要修改你的视图文件show-phone.php，把原来的代码替换成：

<?= Yii::$app->formatter->asPhone($phone, '(###) ###-##-##') ?>

这样就能直接把纯数字的1234567890转换成你要的(123) 456-78-90格式啦。

进阶：全局统一配置格式 #

如果你的项目里很多地方都需要用这个格式，不想每次都写模板字符串，可以在config/web.php里配置Formatter组件：

return [
    // ...其他配置
    'components' => [
        // ...其他组件
        'formatter' => [
            'phoneFormat' => '(###) ###-##-##', // 设置全局默认手机号格式
        ],
    ],
];

配置好之后，视图里只需要写一行就够了：

<?= Yii::$app->formatter->asPhone($phone) ?>

方案二：用字符串工具类手动拼接（适合特殊场景） #

如果因为某些原因不想用Formatter，也可以用Yii2的StringHelper来手动拆分拼接，不过这种方式灵活性稍差，适合固定长度的手机号：

<?php
use yii\helpers\StringHelper;
use yii\helpers\Html;

// 拆分10位手机号并拼接成目标格式
$formatted = sprintf(
    '(%s) %s-%s-%s',
    StringHelper::substr($phone, 0, 3),
    StringHelper::substr($phone, 3, 3),
    StringHelper::substr($phone, 6, 2),
    StringHelper::substr($phone, 8, 2)
);
echo Html::encode($formatted);
?>

小提示 #

Formatter的asPhone方法还支持带国家码的手机号，比如传入+861234567890也能正确格式化，兼容性很强。

内容的提问来源于stack exchange，提问作者ZULI