本文讲述借助第三方包在 Laravel 中实现中文转拼音功能，用到的包是：overtrue/pinyin，github地址：https://github.com/overtrue/pinyin。

一、安装扩展包

执行下面的命令安装扩展包，如果 Laravel 版本较低，可以安装 4.0 版本。

composer require overtrue/pinyin:^5.0

二、示例代码

use OvertruePinyinPinyin;

use AppModelCity;
public function index(){
    $list = City::whereNull('name_en')->get(); // 取出没有英文的数据
    $pinyin = new Pinyin();
    foreach ($list as $item){
        $cn_str = $pinyin->permalink($item['name'],'');  // 中文转拼音
        $cn = str_replace(['qu','xian','shi'],'',$cn_str);  //替换掉区县市后缀
        $item->name_cn = ucfirst($cn);
        $item->save();
    }
}

附、overtrue/pinyin使用说明

拼音风格

除了获取首字母的方法外，所有方法都支持第二个参数，用于指定拼音的格式，可选值为：

  • symbol （默认）声调符号，例如 pīn yīn
  • none 不输出拼音，例如 pin yin
  • number 末尾数字模式的拼音，例如 pin1 yin1

返回值

除了 permalink 返回字符串外，其它方法都返回集合类型 OvertruePinyinCollection：

use OvertruePinyinPinyin;

$pinyin = Pinyin::sentence('你好，世界');

你可以通过以下方式访问集合内容:

echo $pinyin; // nǐ hǎo shì jiè

// 直接将对象转成字符串
$string = (string) $pinyin; // nǐ hǎo shì jiè

$pinyin->toArray(); // ['nǐ', 'hǎo', 'shì', 'jiè']

// 直接使用索引访问
$pinyin[0]; // 'nǐ'

// 使用函数遍历
$pinyin->map('ucfirst'); // ['Nǐ', 'Hǎo', 'Shì', 'Jiè']

// 拼接为字符串
$pinyin->join(' '); // 'nǐ hǎo shì jiè'
$pinyin->join('-'); // 'nǐ-hǎo-shì-jiè'

// 转成 json
$pinyin->toJson(); // '["nǐ","hǎo","shì","jiè"]'
json_encode($pinyin); // '["nǐ","hǎo","shì","jiè"]'

文字段落转拼音

use OvertruePinyinPinyin;

echo Pinyin::sentence('带着希望去旅行，比到达终点更美好');
// dài zhe xī wàng qù lyu xíng ， bǐ dào dá zhōng diǎn gèng měi hǎo

// 去除声调
echo Pinyin::sentence('带着希望去旅行，比到达终点更美好', 'none');
// dai zhe xi wang qu lyu xing ， bi dao da zhong dian geng mei hao

生成用于链接的拼音字符串

通常用于文章链接等，可以使用 permalink 方法获取拼音字符串：

echo Pinyin::permalink('带着希望去旅行'); // dai-zhe-xi-wang-qu-lyu-xing
echo Pinyin::permalink('带着希望去旅行', '.'); // dai.zhe.xi.wang.qu.lyu.xing

获取首字符字符串

通常用于创建搜索用的索引，可以使用 abbr 方法转换：

echo Pinyin::abbr('带着希望去旅行'); // d z x w q l x
echo Pinyin::abbr('带着希望去旅行')->join('-'); // d-z-x-w-q-l-x

echo Pinyin::abbr('你好2018！')->join(''); // nh2018
echo Pinyin::abbr('Happy New Year! 2018！')->join(''); // HNY2018

姓名首字母

将首字作为姓氏转换，其余作为普通词语转换：

echo Pinyin::nameAbbr('欧阳'); // o y
echo Pinyin::nameAbbr('单单单')->join('-'); // s-d-d

姓名转换

姓名的姓的读音有些与普通字不一样，比如 ‘单’ 常见的音为 dan，而作为姓的时候读 shan。

echo Pinyin::name('单某某'); // shàn mǒu mǒu
echo Pinyin::name('单某某', 'none'); // shan mou mou
echo Pinyin::name('单某某', 'none')->join('-'); // shan-mou-mou

多音字

多音字的返回值为关联数组的集合：

$pinyin = Pinyin::polyphones('重庆');

echo $pinyin['重']; // ["zhòng", "chóng", "tóng"]
echo $pinyin['庆']; // ["qìng"]

$pinyin->toArray(); 
// [
//     "重": ["zhòng", "chóng", "tóng"],
//     "庆": ["qìng"]
// ]

单字转拼音

和多音字类似，单字的返回值为字符串，多音字将根据该字字频调整得到常用音：

$pinyin = Pinyin::polyphones('重庆');

echo $pinyin['重']; // "zhòng"
echo $pinyin['庆']; // "qìng"

$pinyin->toArray(); 
// [
//     "重": "zhòng",
//     "庆": "qìng"
// ]

Warning

当单字处理时由于多音字来自词频表中取得常用音，所以在词语环境下可能出现不正确的情况，建议使用多音字处理。