最可靠方案是安装 overtrue/pinyin Composer 包,支持多音字、自动过滤标点、多种模式及 Unicode 兼容;降级用 iconv+正则但不可靠;需防别名冲突、输入污染和并发问题。

PHP 中用 pinyin 扩展生成栏目拼音别名最可靠
直接装 overtrue/pinyin Composer 包,比手写正则或查表靠谱得多。它能处理多音字(默认取常用读音)、自动过滤标点、支持首字母/全拼/数字编号等模式,而且对中文 Unicode 兼容性好。
安装命令:
composer require overtrue/pinyin
基础用法示例:
$pinyin = new \Overtrue\Pinyin\Pinyin();
$alias = $pinyin->permalink('联系我们'); // 返回 'lian-xi-wo-men'
常见注意点:
-
permalink()默认用短横线分隔,要下划线可传第二个参数:$pinyin->permalink('产品中心', '_') - 含英文或数字的栏目名(如“PHP教程”)会被原样保留,不会转拼音
- 空格、括号、斜杠等非文字字符会被自动剔除,不用提前
str_replace
不依赖扩展时用 iconv + 正则做降级方案
服务器没权限装扩展,或项目太老不能用 Composer 时,可用系统级 iconv 尝试转 ASCII,但成功率低、结果不可控,仅适合纯简体且无生僻字的场景。
立即学习“PHP免费学习笔记(深入)”;
典型写法:
$str = iconv('UTF-8', 'ASCII//TRANSLIT', $title);
$alias = preg_replace('/[^a-z0-9]+/', '-', strtolower($str));
这个方案的问题很实在:
- 遇到「重庆」「厦门」这类地名,
iconv常返回问号或空字符串 - 「叶」可能转成
ye或she,完全看系统 locale 设置 - 不支持自定义分隔符,得靠
preg_replace补救 - PHP 8.2+ 在某些 Docker 环境里
iconv可能被禁用
数据库里存拼音别名必须加唯一索引防冲突
多个栏目叫「关于我们」「关于我们简介」,用同一套拼音逻辑可能都生成 guan-yu-wo-men,插入时会报 Duplicate entry 错误。
解决办法:
- 生成别名后先查库:
SELECT COUNT(*) FROM category WHERE alias = ? - 冲突时追加数字后缀,比如
guan-yu-wo-men-2,再校验 - 字段
alias必须建UNIQUE索引,否则并发写入可能漏判 - 别用
INSERT IGNORE直接吞错误——你得知道哪条没插进去
前端提交栏目名含 HTML 标签时,pinyin 不会自动过滤
overtrue/pinyin 只管汉字转拼音,不管输入是否干净。如果用户在后台输入了 ,生成的别名会是 新闻
h1-xin-wen-h1,这不是你想要的。
安全做法是入库前统一清理:
- 用
strip_tags($title)去标签 - 再用
trim(preg_replace('/\s+/', ' ', $title))合并多余空白 - 最后才交给
Pinyin实例处理 - 别在 JS 层就删标签——服务端必须重验











