本文讲述借助第三方包在 Laravel 中实现中文转拼音功能,用到的包是:overtrue/pinyin,github地址:https://github.com/overtrue/pinyin。
一、安装扩展包
执行下面的命令安装扩展包,如果 Laravel 版本较低,可以安装 4.0 版本。
composer require overtrue/pinyin:^5.0
二、示例代码
use Overtrue\Pinyin\Pinyin;
use App\Model\City;
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
返回字符串外,其它方法都返回集合类型 Overtrue\Pinyin\Collection
:
use Overtrue\Pinyin\Pinyin; $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 Overtrue\Pinyin\Pinyin; 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
当单字处理时由于多音字来自词频表中取得常用音,所以在词语环境下可能出现不正确的情况,建议使用多音字处理。