GBK 編碼中,漢字佔 2 字節,區位碼範圍 0x8140 ~ 0xFEFE。將區位碼轉換為無符號整數,對照拼音區間表二分查找對應聲母。本文提供的代碼採用硬編碼映射表 (約 600+ 拼音區間),無外部依賴,適合輕量級場景。
<?php
/**
* 中文轉拼音 (首字母/全拼)
* @param string $str 輸入字符串 (UTF-8/GBK)
* @param string $charset 輸入編碼 'utf-8'|'gbk'
* @param bool $firstLetterOnly 僅返回首字母
* @return string 拼音字符串 (小寫、無分隔)
*/
function chineseToPinyin(string $str, string $charset = 'utf-8', bool $firstLetterOnly = false): string
{
static $pinyinMap = null;
// 延遲初始化映射表 (單例模式)
if ($pinyinMap === null) {
$pinyinMap = buildPinyinMap();
}
// 統一轉為 GBK 處理
if (strtolower($charset) !== 'gbk') {
$str = @iconv($charset, 'GBK//IGNORE', $str);
}
$result = '';
$len = strlen($str);
for ($i = 0; $i < $len; $i++) {
$ord1 = ord($str[$i]);
// ASCII 字符直接保留
if ($ord1 < 0x80) {
$result .= $str[$i];
continue;
}
// 雙字節漢字
if ($i + 1 < $len) {
$ord2 = ord($str[++$i]);
$code = ($ord1 << 8) | $ord2; // 區位碼
// 二分查找映射表
$py = binarySearchPinyin($code, $pinyinMap);
if ($py !== '') {
$result .= $firstLetterOnly ? $py[0] : $py;
}
}
}
return strtolower(preg_replace('/[^a-z0-9]/', '', $result));
}
/** 構建拼音映射表 (區位碼起始值 => 拼音) */
function buildPinyinMap(): array
{
// 精簡版映射表 (完整表約 600+ 項,此處節選關鍵區間)
$raw = [
-20319 => 'a', -20317 => 'ai', -20304 => 'an', -20295 => 'ang', -20292 => 'ao',
-20283 => 'ba', -20265 => 'bai', -20257 => 'ban', -20242 => 'bang', -20230 => 'bao',
-20051 => 'bei', -20036 => 'ben', -20032 => 'beng', -20026 => 'bi', -20002 => 'bian',
-19990 => 'biao', -19986 => 'bie', -19982 => 'bin', -19976 => 'bing', -19805 => 'bo',
-19784 => 'bu', -19775 => 'ca', -19774 => 'cai', -19763 => 'can', -19756 => 'cang',
-19751 => 'cao', -19746 => 'ce', -19741 => 'ceng', -19739 => 'cha', -19728 => 'chai',
-19725 => 'chan', -19715 => 'chang', -19540 => 'chao', -19531 => 'che', -19525 => 'chen',
-19515 => 'cheng', -19500 => 'chi', -19484 => 'chong', -19479 => 'chou', -19467 => 'chu',
-19289 => 'chuai', -19288 => 'chuan', -19281 => 'chuang', -19275 => 'chui', -19270 => 'chun',
-19263 => 'chuo', -19261 => 'ci', -19249 => 'cong', -19243 => 'cou', -19242 => 'cu',
-19238 => 'cuan', -19235 => 'cui', -19227 => 'cun', -19224 => 'cuo', -19218 => 'da',
-19212 => 'dai', -19038 => 'dan', -19023 => 'dang', -19018 => 'dao', -19006 => 'de',
-19003 => 'deng', -18996 => 'di', -18977 => 'dian', -18961 => 'diao', -18952 => 'die',
-18783 => 'ding', -18774 => 'diu', -18773 => 'dong', -18763 => 'dou', -18756 => 'du',
-18741 => 'duan', -18735 => 'dui', -18731 => 'dun', -18722 => 'duo', -18710 => 'e',
-18697 => 'en', -18696 => 'er', -18526 => 'fa', -18518 => 'fan', -18501 => 'fang',
-18490 => 'fei', -18478 => 'fen', -18463 => 'feng', -18448 => 'fo', -18447 => 'fou',
-18446 => 'fu', -18239 => 'ga', -18237 => 'gai', -18231 => 'gan', -18220 => 'gang',
-18211 => 'gao', -18201 => 'ge', -18184 => 'gei', -18183 => 'gen', -18181 => 'geng',
-18012 => 'gong', -17997 => 'gou', -17988 => 'gu', -17970 => 'gua', -17964 => 'guai',
-17961 => 'guan', -17950 => 'guang', -17947 => 'gui', -17931 => 'gun', -17928 => 'guo',
-17922 => 'ha', -17759 => 'hai', -17752 => 'han', -17733 => 'hang', -17730 => 'hao',
-17721 => 'he', -17703 => 'hei', -17701 => 'hen', -17697 => 'heng', -17692 => 'hong',
-17683 => 'hou', -17676 => 'hu', -17496 => 'hua', -17487 => 'huai', -17482 => 'huan',
-17468 => 'huang', -17454 => 'hui', -17433 => 'hun', -17427 => 'huo', -17417 => 'ji',
-17202 => 'jia', -17185 => 'jian', -16983 => 'jiang', -16970 => 'jiao', -16942 => 'jie',
-16915 => 'jin', -16733 => 'jing', -16708 => 'jiong', -16706 => 'jiu', -16689 => 'ju',
-16664 => 'juan', -16657 => 'jue', -16647 => 'jun', -16474 => 'ka', -16470 => 'kai',
-16465 => 'kan', -16459 => 'kang', -16452 => 'kao', -16448 => 'ke', -16447 => 'ken',
-16446 => 'keng', -16433 => 'kong', -16429 => 'kou', -16427 => 'ku', -16423 => 'kua',
-16419 => 'kuai', -16412 => 'kuan', -16407 => 'kuang', -16403 => 'kui', -16401 => 'kun',
-16393 => 'kuo', -16220 => 'la', -16216 => 'lai', -16212 => 'lan', -16205 => 'lang',
-16202 => 'lao', -16187 => 'le', -16180 => 'lei', -16171 => 'leng', -16169 => 'li',
-16158 => 'lia', -16155 => 'lian', -15959 => 'liang', -15958 => 'liao', -15944 => 'lie',
-15933 => 'lin', -15920 => 'ling', -15915 => 'liu', -15903 => 'long', -15889 => 'lou',
-15878 => 'lu', -15707 => 'lv', -15701 => 'luan', -15681 => 'lue', -15667 => 'lun',
-15661 => 'luo', -15659 => 'ma', -15652 => 'mai', -15640 => 'man', -15631 => 'mang',
-15454 => 'mao', -15448 => 'me', -15436 => 'mei', -15435 => 'men', -15419 => 'meng',
-15416 => 'mi', -15408 => 'mian', -15394 => 'miao', -15385 => 'mie', -15377 => 'min',
-15375 => 'ming', -15369 => 'miu', -15363 => 'mo', -15362 => 'mou', -15183 => 'mu',
-15180 => 'na', -15165 => 'nai', -15158 => 'nan', -15153 => 'nang', -15150 => 'nao',
-15149 => 'ne', -15144 => 'nei', -15143 => 'nen', -15141 => 'neng', -15140 => 'ni',
-15139 => 'nian', -15128 => 'niang', -15121 => 'niao', -15119 => 'nie', -15117 => 'nin',
-15110 => 'ning', -15109 => 'niu', -14941 => 'nong', -14937 => 'nu', -14933 => 'nv',
-14930 => 'nuan', -14929 => 'nue', -14928 => 'nuo', -14926 => 'o', -14922 => 'ou',
-14921 => 'pa', -14914 => 'pai', -14908 => 'pan', -14902 => 'pang', -14894 => 'pao',
-14889 => 'pei', -14882 => 'pen', -14873 => 'peng', -14871 => 'pi', -14857 => 'pian',
-14678 => 'piao', -14674 => 'pie', -14670 => 'pin', -14668 => 'ping', -14663 => 'po',
-14654 => 'pu', -14645 => 'qi', -14630 => 'qia', -14594 => 'qian', -14429 => 'qiang',
-14407 => 'qiao', -14399 => 'qie', -14384 => 'qin', -14379 => 'qing', -14368 => 'qiong',
-14355 => 'qiu', -14353 => 'qu', -14345 => 'quan', -14170 => 'que', -14159 => 'qun',
-14151 => 'ran', -14149 => 'rang', -14145 => 'rao', -14140 => 're', -14137 => 'ren',
-14135 => 'reng', -14125 => 'ri', -14123 => 'rong', -14122 => 'rou', -14112 => 'ru',
-14109 => 'ruan', -14099 => 'rui', -14097 => 'run', -14094 => 'ruo', -14092 => 'sa',
-14090 => 'sai', -14087 => 'san', -14083 => 'sang', -13917 => 'sao', -13914 => 'se',
-13910 => 'sen', -13907 => 'seng', -13906 => 'sha', -13905 => 'shai', -13896 => 'shan',
-13894 => 'shang', -13878 => 'shao', -13870 => 'she', -13859 => 'shen', -13847 => 'sheng',
-13831 => 'shi', -13658 => 'shou', -13611 => 'shu', -13601 => 'shua', -13406 => 'shuai',
-13404 => 'shuan', -13400 => 'shuang', -13398 => 'shui', -13395 => 'shun', -13391 => 'shuo',
-13387 => 'si', -13383 => 'song', -13367 => 'sou', -13359 => 'su', -13356 => 'suan',
-13343 => 'sui', -13340 => 'sun', -13329 => 'suo', -13326 => 'ta', -13318 => 'tai',
-13147 => 'tan', -13138 => 'tang', -13120 => 'tao', -13107 => 'te', -13096 => 'teng',
-13095 => 'ti', -13091 => 'tian', -13076 => 'tiao', -13068 => 'tie', -13063 => 'ting',
-13060 => 'tong', -12888 => 'tou', -12875 => 'tu', -12871 => 'tuan', -12860 => 'tui',
-12858 => 'tun', -12852 => 'tuo', -12849 => 'wa', -12838 => 'wai', -12831 => 'wan',
-12829 => 'wang', -12812 => 'wei', -12802 => 'wen', -12607 => 'weng', -12597 => 'wo',
-12594 => 'wu', -12585 => 'xi', -12556 => 'xia', -12359 => 'xian', -12346 => 'xiang',
-12320 => 'xiao', -12300 => 'xie', -12120 => 'xin', -12099 => 'xing', -12089 => 'xiong',
-12074 => 'xiu', -12067 => 'xu', -12058 => 'xuan', -12039 => 'xue', -11867 => 'xun',
-11861 => 'ya', -11847 => 'yan', -11831 => 'yang', -11798 => 'yao', -11781 => 'ye',
-11604 => 'yi', -11589 => 'yin', -11536 => 'ying', -11358 => 'yo', -11340 => 'yong',
-11339 => 'you', -11324 => 'yu', -11303 => 'yuan', -11097 => 'yue', -11077 => 'yun',
-11067 => 'za', -11055 => 'zai', -11052 => 'zan', -11045 => 'zang', -11041 => 'zao',
-11038 => 'ze', -11024 => 'zei', -11020 => 'zen', -11019 => 'zeng', -11018 => 'zha',
-11014 => 'zhai', -10838 => 'zhan', -10832 => 'zhang', -10815 => 'zhao', -10800 => 'zhe',
-10790 => 'zhen', -10780 => 'zheng', -10764 => 'zhi', -10587 => 'zhong', -10544 => 'zhou',
-10533 => 'zhu', -10519 => 'zhua', -10331 => 'zhuai', -10329 => 'zhuan', -10328 => 'zhuang',
-10322 => 'zhui', -10315 => 'zhun', -10309 => 'zhuo', -10307 => 'zi', -10296 => 'zong',
-10281 => 'zou', -10274 => 'zu', -10270 => 'zuan', -10262 => 'zui', -10260 => 'zun',
-10256 => 'zuo',
];
krsort($raw); // 降序排列,便於二分查找
return $raw;
}
/** 二分查找拼音 */
function binarySearchPinyin(int $code, array $map): string
{
$keys = array_keys($map);
$low = 0;
$high = count($keys) - 1;
while ($low <= $high) {
$mid = (($low + $high) >> 1);
if ($keys[$mid] <= $code) {
return $map[$keys[$mid]];
}
$high = $mid - 1;
}
return '';
}
<?php
echo chineseToPinyin('安徽軟件有限公司'); // anhuiruanjianyouxiangongsi
echo chineseToPinyin('安徽軟件有限公司', 'utf-8', true); // ahrjyxgs (首字母)
echo chineseToPinyin('PHP中文轉拼音', 'utf-8'); // phpzhongwenzhuanpinyin
| 庫 | 特點 | 安裝 |
|---|---|---|
| overtrue/pinyin | 最流行、支援多音字、分詞、首字母、Composer 安裝 | composer require overtrue/pinyin |
| pinyin-php/pinyin | 輕量、PSR-4、支援自定義詞典 | composer require pinyin-php/pinyin |
| jiannei/laravel-pinyin | Laravel 專用門面、模型觀察者自動生成拼音欄位 | composer require jiannei/laravel-pinyin |