新增拼音处理

2023-08-24 10:40:24 +08:00 · 2023-08-24 10:40:24 +08:00 · bb9ed8442b
commit bb9ed8442b
parent bf16a4d272
19 changed files with 43109 additions and 1 deletions
--- a/.gitignore
+++ b/.gitignore
@ -13,4 +13,3 @@ public/protocol.html
 runtime/swoole.pid
 cert_crmeb copy.key
 dump.rdb
-/vendor/*
--- a/vendor/overtrue/pinyin/.github/FUNDING.yml
+++ b/vendor/overtrue/pinyin/.github/FUNDING.yml
@ -0,0 +1,9 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: overtrue
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+custom: # Replace with a single custom sponsorship URL
--- a/vendor/overtrue/pinyin/.github/dependabot.yml
+++ b/vendor/overtrue/pinyin/.github/dependabot.yml
@ -0,0 +1,12 @@
+version: 2
+updates:
+- package-ecosystem: composer
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "21:00"
+  open-pull-requests-limit: 10
+  ignore:
+  - dependency-name: phpunit/phpunit
+    versions:
+    - ">= 8.a, < 9"
--- a/vendor/overtrue/pinyin/LICENSE
+++ b/vendor/overtrue/pinyin/LICENSE
@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 安正超
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
--- a/vendor/overtrue/pinyin/README.md
+++ b/vendor/overtrue/pinyin/README.md
@ -0,0 +1,130 @@
+<h1 align="center">Pinyin</h1>
+
+<p align="center">
+
+[![Build Status](https://travis-ci.org/overtrue/pinyin.svg?branch=master)](https://travis-ci.org/overtrue/pinyin)
+[![Latest Stable Version](https://poser.pugx.org/overtrue/pinyin/v/stable.svg)](https://packagist.org/packages/overtrue/pinyin) [![Total Downloads](https://poser.pugx.org/overtrue/pinyin/downloads.svg)](https://packagist.org/packages/overtrue/pinyin) [![Latest Unstable Version](https://poser.pugx.org/overtrue/pinyin/v/unstable.svg)](https://packagist.org/packages/overtrue/pinyin) [![License](https://poser.pugx.org/overtrue/pinyin/license.svg)](https://packagist.org/packages/overtrue/pinyin)
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/overtrue/pinyin/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/overtrue/pinyin/?branch=master)
+[![Code Coverage](https://scrutinizer-ci.com/g/overtrue/pinyin/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/overtrue/pinyin/?branch=master)
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fovertrue%2Fpinyin.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fovertrue%2Fpinyin?ref=badge_shield)
+
+</p>
+
+:cn: 基于 [CC-CEDICT](http://cc-cedict.org/wiki/) 词典的中文转拼音工具，更准确的支持多音字的汉字转拼音解决方案。
+
+
+## 安装
+
+使用 Composer 安装:
+
+```
+$ composer require "overtrue/pinyin:~4.0"
+```
+
+## 使用
+
+可选转换方案：
+
+- 内存型，适用于服务器内存空间较富余，优点：转换快
+- 小内存型(默认)，适用于内存比较紧张的环境，优点：占用内存小，转换不如内存型快
+- I/O型，适用于虚拟机，内存限制比较严格环境。优点：非常微小内存消耗。缺点：转换慢，不如内存型转换快,php >= 5.5
+
+## 可用选项：
+
+|      选项      | 描述                                                |
+| -------------  | ---------------------------------------------------|
+| `PINYIN_TONE`  | UNICODE 式音调：`měi hǎo`                    |
+| `PINYIN_ASCII_TONE`  | 带数字式音调：  `mei3 hao3`                    |
+| `PINYIN_NO_TONE`    |  无音调：`mei hao` | 
+| `PINYIN_KEEP_NUMBER`    | 保留数字  | 
+| `PINYIN_KEEP_ENGLISH`   | 保留英文   | 
+| `PINYIN_KEEP_PUNCTUATION`   |  保留标点  | 
+| `PINYIN_UMLAUT_V` | 使用 `v` 代替 `yu`, 例如：吕 `lyu` 将会转为 `lv` |
+
+### 拼音数组
+
+```php
+use Overtrue\Pinyin\Pinyin;
+
+// 小内存型
+$pinyin = new Pinyin(); // 默认
+// 内存型
+// $pinyin = new Pinyin('\\Overtrue\\Pinyin\\MemoryFileDictLoader');
+// I/O型
+// $pinyin = new Pinyin('\\Overtrue\\Pinyin\\GeneratorFileDictLoader');
+
+$pinyin->convert('带着希望去旅行，比到达终点更美好');
+// ["dai", "zhe", "xi", "wang", "qu", "lyu", "xing", "bi", "dao", "da", "zhong", "dian", "geng", "mei", "hao"]
+
+$pinyin->convert('带着希望去旅行，比到达终点更美好', PINYIN_TONE);
+// ["dài","zhe","xī","wàng","qù","lǚ","xíng","bǐ","dào","dá","zhōng","diǎn","gèng","měi","hǎo"]
+
+$pinyin->convert('带着希望去旅行，比到达终点更美好', PINYIN_ASCII_TONE);
+//["dai4","zhe","xi1","wang4","qu4","lyu3","xing2","bi3","dao4","da2","zhong1","dian3","geng4","mei3","hao3"]
+```
+
+- 小内存型: 将字典分片载入内存
+- 内存型: 将所有字典预先载入内存
+- I/O型: 不载入内存，将字典使用文件流打开逐行遍历并运用php5.5生成器(yield)特性分配单行内存
+
+
+### 生成用于链接的拼音字符串
+
+```php
+$pinyin->permalink('带着希望去旅行'); // dai-zhe-xi-wang-qu-lyu-xing
+$pinyin->permalink('带着希望去旅行', '.'); // dai.zhe.xi.wang.qu.lyu.xing
+```
+
+### 获取首字符字符串
+
+```php
+$pinyin->abbr('带着希望去旅行'); // dzxwqlx
+$pinyin->abbr('带着希望去旅行', '-'); // d-z-x-w-q-l-x
+
+$pinyin->abbr('你好2018！', PINYIN_KEEP_NUMBER); // nh2018
+$pinyin->abbr('Happy New Year! 2018！', PINYIN_KEEP_ENGLISH); // HNY2018
+```
+
+### 翻译整段文字为拼音
+
+将会保留中文字符：`，。 ！ ？ ： “ ” ‘ ’` 并替换为对应的英文符号。
+
+```php
+$pinyin->sentence('带着希望去旅行，比到达终点更美好！');
+// dai zhe xi wang qu lyu xing, bi dao da zhong dian geng mei hao!
+
+$pinyin->sentence('带着希望去旅行，比到达终点更美好！', PINYIN_TONE);
+// dài zhe xī wàng qù lǚ xíng, bǐ dào dá zhōng diǎn gèng měi hǎo!
+```
+
+### 翻译姓名
+
+姓名的姓的读音有些与普通字不一样，比如 ‘单’ 常见的音为 `dan`，而作为姓的时候读 `shan`。
+
+```php
+$pinyin->name('单某某'); // ['shan', 'mou', 'mou']
+$pinyin->name('单某某', PINYIN_TONE); // ["shàn","mǒu","mǒu"]
+```
+
+更多使用请参考 [测试用例](https://github.com/overtrue/pinyin/blob/master/tests/AbstractDictLoaderTestCase.php)。
+
+## 在 Laravel 中使用
+
+独立的包在这里：[overtrue/laravel-pinyin](https://github.com/overtrue/laravel-pinyin)
+
+## Contribution
+欢迎提意见及完善补充词库 [`overtrue/pinyin-dictionary-maker`](https://github.com/overtrue/pinyin-dictionary-maker/tree/master/patches) :kiss:
+
+## 参考
+
+- [详细参考资料](https://github.com/overtrue/pinyin-resources)
+
+## PHP 扩展包开发
+
+> 想知道如何从零开始构建 PHP 扩展包？
+>
+> 请关注我的实战课程，我会在此课程中分享一些扩展开发经验 —— [《PHP 扩展包实战教程 - 从入门到发布》](https://learnku.com/courses/creating-package)
+
+# License
+
+[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fovertrue%2Fpinyin.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fovertrue%2Fpinyin?ref=badge_large)
--- a/vendor/overtrue/pinyin/composer.json
+++ b/vendor/overtrue/pinyin/composer.json
@ -0,0 +1,68 @@
+{
+    "name": "overtrue/pinyin",
+    "description": "Chinese to pinyin translator.",
+    "keywords": [
+        "chinese",
+        "pinyin",
+        "cn2pinyin"
+    ],
+    "homepage": "https://github.com/overtrue/pinyin",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "overtrue",
+            "homepage": "http://github.com/overtrue",
+            "email": "anzhengchao@gmail.com"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "Overtrue\\Pinyin\\": "src/"
+        },
+        "files": ["src/const.php"]
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Overtrue\\Pinyin\\Test\\": "tests/"
+        }
+    },
+    "require": {
+        "php":">=7.1"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "~8.0",
+        "brainmaestro/composer-git-hooks": "^2.7",
+        "friendsofphp/php-cs-fixer": "^2.16"
+    },
+    "extra": {
+        "hooks": {
+            "pre-commit": [
+                "composer test",
+                "composer fix-style"
+            ],
+            "pre-push": [
+                "composer test",
+                "composer check-style"
+            ]
+        }
+    },
+    "scripts": {
+        "post-update-cmd": [
+            "cghooks update"
+        ],
+        "post-merge": "composer install",
+        "post-install-cmd": [
+            "cghooks add --ignore-lock",
+            "cghooks update"
+        ],
+        "cghooks": "vendor/bin/cghooks",
+        "check-style": "php-cs-fixer fix --using-cache=no --diff --config=.php_cs --dry-run --ansi",
+        "fix-style": "php-cs-fixer fix --using-cache=no --config=.php_cs --ansi",
+        "test": "vendor/bin/phpunit --colors=always"
+    },
+    "scripts-descriptions": {
+        "test": "Run all tests.",
+        "check-style": "Run style checks (only dry run - no fixing!).",
+        "fix-style": "Run style checks and fix violations."
+    }
+}
--- a/vendor/overtrue/pinyin/data/surnames
+++ b/vendor/overtrue/pinyin/data/surnames
@ -0,0 +1,86 @@
+<?php
+ return array (
+  '万俟' => '	mò	qí',
+  '尉迟' => '	yù	chí',
+  '单于' => '	chán	yú',
+  '不' => '	fǒu',
+  '沈' => '	shěn',
+  '称' => '	chēng',
+  '车' => '	chē',
+  '万' => '	wàn',
+  '汤' => '	tāng',
+  '阿' => '	ā',
+  '丁' => '	dīng',
+  '强' => '	qiáng',
+  '仇' => '	qiú',
+  '叶' => '	yè',
+  '阚' => '	kàn',
+  '乐' => '	yuè',
+  '乜' => '	niè',
+  '陆' => '	lù',
+  '殷' => '	yīn',
+  '牟' => '	móu',
+  '区' => '	ōu',
+  '宿' => '	sù',
+  '俞' => '	yú',
+  '余' => '	yú',
+  '齐' => '	qí',
+  '许' => '	xǔ',
+  '信' => '	xìn',
+  '无' => '	wú',
+  '浣' => '	wǎn',
+  '艾' => '	ài',
+  '浅' => '	qiǎn',
+  '烟' => '	yān',
+  '蓝' => '	lán',
+  '於' => '	yú',
+  '寻' => '	xún',
+  '殳' => '	shū',
+  '思' => '	sī',
+  '鸟' => '	niǎo',
+  '卜' => '	bǔ',
+  '单' => '	shàn',
+  '南' => '	nán',
+  '柏' => '	bǎi',
+  '朴' => '	piáo',
+  '繁' => '	pó',
+  '曾' => '	zēng',
+  '瞿' => '	qú',
+  '缪' => '	miào',
+  '石' => '	shí',
+  '冯' => '	féng',
+  '覃' => '	qín',
+  '幺' => '	yāo',
+  '种' => '	chóng',
+  '折' => '	shè',
+  '燕' => '	yān',
+  '纪' => '	jǐ',
+  '过' => '	guō',
+  '华' => '	huà',
+  '冼' => '	xiǎn',
+  '秘' => '	bì',
+  '重' => '	chóng',
+  '解' => '	xiè',
+  '那' => '	nā',
+  '和' => '	hé',
+  '贾' => '	jiǎ',
+  '塔' => '	tǎ',
+  '盛' => '	shèng',
+  '查' => '	zhā',
+  '盖' => '	gě',
+  '居' => '	jū',
+  '哈' => '	hǎ',
+  '的' => '	dē',
+  '薄' => '	bó',
+  '佴' => '	nài',
+  '六' => '	lù',
+  '都' => '	dū',
+  '翟' => '	zhái',
+  '扎' => '	zā',
+  '藏' => '	zàng',
+  '粘' => '	niàn',
+  '难' => '	nàn',
+  '若' => '	ruò',
+  '貟' => '	yùn',
+  '贠' => '	yùn',
+);
--- a/vendor/overtrue/pinyin/data/words_0
+++ b/vendor/overtrue/pinyin/data/words_0
--- a/vendor/overtrue/pinyin/data/words_1
+++ b/vendor/overtrue/pinyin/data/words_1
--- a/vendor/overtrue/pinyin/data/words_2
+++ b/vendor/overtrue/pinyin/data/words_2
--- a/vendor/overtrue/pinyin/data/words_3
+++ b/vendor/overtrue/pinyin/data/words_3
--- a/vendor/overtrue/pinyin/data/words_4
+++ b/vendor/overtrue/pinyin/data/words_4
--- a/vendor/overtrue/pinyin/data/words_5
+++ b/vendor/overtrue/pinyin/data/words_5
--- a/vendor/overtrue/pinyin/src/DictLoaderInterface.php
+++ b/vendor/overtrue/pinyin/src/DictLoaderInterface.php
@ -0,0 +1,42 @@
+<?php
+
+/*
+ * This file is part of the overtrue/pinyin.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\Pinyin;
+
+use Closure;
+
+/**
+ * Dict loader interface.
+ */
+interface DictLoaderInterface
+{
+    /**
+     * Load dict.
+     *
+     * <pre>
+     * [
+     *     '响应时间' => "[\t]xiǎng[\t]yìng[\t]shí[\t]jiān",
+     *     '长篇连载' => '[\t]cháng[\t]piān[\t]lián[\t]zǎi',
+     *     //...
+     * ]
+     * </pre>
+     *
+     * @param Closure $callback
+     */
+    public function map(Closure $callback);
+
+    /**
+     * Load surname dict.
+     *
+     * @param Closure $callback
+     */
+    public function mapSurname(Closure $callback);
+}
--- a/vendor/overtrue/pinyin/src/FileDictLoader.php
+++ b/vendor/overtrue/pinyin/src/FileDictLoader.php
@ -0,0 +1,73 @@
+<?php
+
+/*
+ * This file is part of the overtrue/pinyin.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\Pinyin;
+
+use Closure;
+
+class FileDictLoader implements DictLoaderInterface
+{
+    /**
+     * Words segment name.
+     *
+     * @var string
+     */
+    protected $segmentName = 'words_%s';
+
+    /**
+     * Dict path.
+     *
+     * @var string
+     */
+    protected $path;
+
+    /**
+     * Constructor.
+     *
+     * @param string $path
+     */
+    public function __construct($path)
+    {
+        $this->path = $path;
+    }
+
+    /**
+     * Load dict.
+     *
+     * @param Closure $callback
+     */
+    public function map(Closure $callback)
+    {
+        for ($i = 0; $i < 100; ++$i) {
+            $segment = $this->path . '/' . sprintf($this->segmentName, $i);
+
+            if (file_exists($segment)) {
+                $dictionary = (array) include $segment;
+                $callback($dictionary);
+            }
+        }
+    }
+
+    /**
+     * Load surname dict.
+     *
+     * @param Closure $callback
+     */
+    public function mapSurname(Closure $callback)
+    {
+        $surnames = $this->path . '/surnames';
+
+        if (file_exists($surnames)) {
+            $dictionary = (array) include $surnames;
+            $callback($dictionary);
+        }
+    }
+}
--- a/vendor/overtrue/pinyin/src/GeneratorFileDictLoader.php
+++ b/vendor/overtrue/pinyin/src/GeneratorFileDictLoader.php
@ -0,0 +1,142 @@
+<?php
+
+/*
+ * This file is part of the overtrue/pinyin.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\Pinyin;
+
+use Closure;
+use SplFileObject;
+use Generator;
+
+class GeneratorFileDictLoader implements DictLoaderInterface
+{
+    /**
+     * Data directory.
+     *
+     * @var string
+     */
+    protected $path;
+
+    /**
+     * Words segment name.
+     *
+     * @var string
+     */
+    protected $segmentName = 'words_%s';
+
+    /**
+     * SplFileObjects.
+     *
+     * @var array
+     */
+    protected static $handles = [];
+
+    /**
+     * surnames.
+     *
+     * @var SplFileObject
+     */
+    protected static $surnamesHandle;
+
+    /**
+     * Constructor.
+     *
+     * @param string $path
+     */
+    public function __construct($path)
+    {
+        $this->path = $path;
+
+        for ($i = 0; $i < 100; ++$i) {
+            $segment = $this->path . '/' . sprintf($this->segmentName, $i);
+
+            if (file_exists($segment) && is_file($segment)) {
+                array_push(static::$handles, $this->openFile($segment));
+            }
+        }
+    }
+
+    /**
+     * Construct a new file object.
+     *
+     * @param string $filename file path
+     * @param string $mode     file open mode
+     *
+     * @return SplFileObject
+     */
+    protected function openFile($filename, $mode = 'r')
+    {
+        return new SplFileObject($filename, $mode);
+    }
+
+    /**
+     * get Generator syntax.
+     *
+     * @param array $handles SplFileObjects
+     *
+     * @return Generator
+     */
+    protected function getGenerator(array $handles)
+    {
+        foreach ($handles as $handle) {
+            $handle->seek(0);
+            while (false === $handle->eof()) {
+                $string = str_replace(['\'', ' ', PHP_EOL, ','], '', $handle->fgets());
+
+                if (false === strpos($string, '=>')) {
+                    continue;
+                }
+
+                list($string, $pinyin) = explode('=>', $string);
+
+                yield $string => $pinyin;
+            }
+        }
+    }
+
+    /**
+     * Traverse the stream.
+     *
+     * @param Generator $generator
+     * @param Closure   $callback
+     *
+     * @author Seven Du <shiweidu@outlook.com>
+     */
+    protected function traversing(Generator $generator, Closure $callback)
+    {
+        foreach ($generator as $string => $pinyin) {
+            $callback([$string => $pinyin]);
+        }
+    }
+
+    /**
+     * Load dict.
+     *
+     * @param Closure $callback
+     */
+    public function map(Closure $callback)
+    {
+        $this->traversing($this->getGenerator(static::$handles), $callback);
+    }
+
+    /**
+     * Load surname dict.
+     *
+     * @param Closure $callback
+     */
+    public function mapSurname(Closure $callback)
+    {
+        if (!static::$surnamesHandle instanceof SplFileObject) {
+            static::$surnamesHandle = $this->openFile($this->path . '/surnames');
+        }
+
+        $this->traversing($this->getGenerator([static::$surnamesHandle]), $callback);
+    }
+}
--- a/vendor/overtrue/pinyin/src/MemoryFileDictLoader.php
+++ b/vendor/overtrue/pinyin/src/MemoryFileDictLoader.php
@ -0,0 +1,93 @@
+<?php
+
+/*
+ * This file is part of the overtrue/pinyin.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\Pinyin;
+
+use Closure;
+
+class MemoryFileDictLoader implements DictLoaderInterface
+{
+    /**
+     * Data directory.
+     *
+     * @var string
+     */
+    protected $path;
+
+    /**
+     * Words segment name.
+     *
+     * @var string
+     */
+    protected $segmentName = 'words_%s';
+
+    /**
+     * Segment files.
+     *
+     * @var array
+     */
+    protected $segments = [];
+
+    /**
+     * Surname cache.
+     *
+     * @var array
+     */
+    protected $surnames = [];
+
+    /**
+     * Constructor.
+     *
+     * @param string $path
+     */
+    public function __construct($path)
+    {
+        $this->path = $path;
+
+        for ($i = 0; $i < 100; ++$i) {
+            $segment = $path . '/' . sprintf($this->segmentName, $i);
+
+            if (file_exists($segment)) {
+                $this->segments[] = (array) include $segment;
+            }
+        }
+    }
+
+    /**
+     * Load dict.
+     *
+     * @param Closure $callback
+     */
+    public function map(Closure $callback)
+    {
+        foreach ($this->segments as $dictionary) {
+            $callback($dictionary);
+        }
+    }
+
+    /**
+     * Load surname dict.
+     *
+     * @param Closure $callback
+     */
+    public function mapSurname(Closure $callback)
+    {
+        if (empty($this->surnames)) {
+            $surnames = $this->path . '/surnames';
+
+            if (file_exists($surnames)) {
+                $this->surnames = (array) include $surnames;
+            }
+        }
+
+        $callback($this->surnames);
+    }
+}
--- a/vendor/overtrue/pinyin/src/Pinyin.php
+++ b/vendor/overtrue/pinyin/src/Pinyin.php
@ -0,0 +1,343 @@
+<?php
+
+/*
+ * This file is part of the overtrue/pinyin.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Overtrue\Pinyin;
+
+use InvalidArgumentException;
+
+class Pinyin
+{
+    /**
+     * Dict loader.
+     *
+     * @var \Overtrue\Pinyin\DictLoaderInterface
+     */
+    protected $loader;
+
+    /**
+     * Punctuations map.
+     *
+     * @var array
+     */
+    protected $punctuations = [
+        '，' => ',',
+        '。' => '.',
+        '！' => '!',
+        '？' => '?',
+        '：' => ':',
+        '“' => '"',
+        '”' => '"',
+        '‘' => "'",
+        '’' => "'",
+        '_' => '_',
+    ];
+
+    /**
+     * Constructor.
+     *
+     * @param string $loaderName
+     */
+    public function __construct($loaderName = null)
+    {
+        $this->loader = $loaderName ?: 'Overtrue\\Pinyin\\FileDictLoader';
+    }
+
+    /**
+     * Convert string to pinyin.
+     *
+     * @param string $string
+     * @param int    $option
+     *
+     * @return array
+     */
+    public function convert($string, $option = PINYIN_DEFAULT)
+    {
+        $pinyin = $this->romanize($string, $option);
+
+        return $this->splitWords($pinyin, $option);
+    }
+
+    /**
+     * Convert string (person name) to pinyin.
+     *
+     * @param string $stringName
+     * @param int    $option
+     *
+     * @return array
+     */
+    public function name($stringName, $option = PINYIN_NAME)
+    {
+        $option = $option | PINYIN_NAME;
+
+        $pinyin = $this->romanize($stringName, $option);
+
+        return $this->splitWords($pinyin, $option);
+    }
+
+    /**
+     * Return a pinyin permalink from string.
+     *
+     * @param string $string
+     * @param string $delimiter
+     * @param int    $option
+     *
+     * @return string
+     */
+    public function permalink($string, $delimiter = '-', $option = PINYIN_DEFAULT)
+    {
+        if (\is_int($delimiter)) {
+            list($option, $delimiter) = [$delimiter, '-'];
+        }
+
+        if (!in_array($delimiter, ['_', '-', '.', ''], true)) {
+            throw new InvalidArgumentException("Delimiter must be one of: '_', '-', '', '.'.");
+        }
+
+        return implode($delimiter, $this->convert($string, $option | \PINYIN_KEEP_NUMBER | \PINYIN_KEEP_ENGLISH));
+    }
+
+    /**
+     * Return first letters.
+     *
+     * @param string $string
+     * @param string $delimiter
+     * @param int    $option
+     *
+     * @return string
+     */
+    public function abbr($string, $delimiter = '', $option = PINYIN_DEFAULT)
+    {
+        if (\is_int($delimiter)) {
+            list($option, $delimiter) = [$delimiter, ''];
+        }
+
+        return implode($delimiter, array_map(function ($pinyin) {
+            return \is_numeric($pinyin) || preg_match('/\d+/', $pinyin) ? $pinyin : mb_substr($pinyin, 0, 1);
+        }, $this->convert($string, $option | PINYIN_NO_TONE)));
+    }
+
+    /**
+     * Chinese phrase to pinyin.
+     *
+     * @param string $string
+     * @param string $delimiter
+     * @param int    $option
+     *
+     * @return string
+     */
+    public function phrase($string, $delimiter = ' ', $option = PINYIN_DEFAULT)
+    {
+        if (\is_int($delimiter)) {
+            list($option, $delimiter) = [$delimiter, ' '];
+        }
+
+        return implode($delimiter, $this->convert($string, $option));
+    }
+
+    /**
+     * Chinese to pinyin sentence.
+     *
+     * @param string $string
+     * @param string $delimiter
+     * @param int    $option
+     *
+     * @return string
+     */
+    public function sentence($string, $delimiter = ' ', $option = \PINYIN_NO_TONE)
+    {
+        if (\is_int($delimiter)) {
+            list($option, $delimiter) = [$delimiter, ' '];
+        }
+
+        return implode($delimiter, $this->convert($string, $option | \PINYIN_KEEP_PUNCTUATION | \PINYIN_KEEP_ENGLISH | \PINYIN_KEEP_NUMBER));
+    }
+
+    /**
+     * Loader setter.
+     *
+     * @param \Overtrue\Pinyin\DictLoaderInterface $loader
+     *
+     * @return $this
+     */
+    public function setLoader(DictLoaderInterface $loader)
+    {
+        $this->loader = $loader;
+
+        return $this;
+    }
+
+    /**
+     * Return dict loader,.
+     *
+     * @return \Overtrue\Pinyin\DictLoaderInterface
+     */
+    public function getLoader()
+    {
+        if (!($this->loader instanceof DictLoaderInterface)) {
+            $dataDir = dirname(__DIR__) . '/data/';
+
+            $loaderName = $this->loader;
+            $this->loader = new $loaderName($dataDir);
+        }
+
+        return $this->loader;
+    }
+
+    /**
+     * Convert Chinese to pinyin.
+     *
+     * @param string $string
+     * @param int    $option
+     *
+     * @return string
+     */
+    protected function romanize($string, $option = \PINYIN_DEFAULT)
+    {
+        $string = $this->prepare($string, $option);
+
+        $dictLoader = $this->getLoader();
+
+        if ($this->hasOption($option, \PINYIN_NAME)) {
+            $string = $this->convertSurname($string, $dictLoader);
+        }
+
+        $dictLoader->map(function ($dictionary) use (&$string) {
+            $string = strtr($string, $dictionary);
+        });
+
+        return $string;
+    }
+
+    /**
+     * Convert Chinese Surname to pinyin.
+     *
+     * @param string                               $string
+     * @param \Overtrue\Pinyin\DictLoaderInterface $dictLoader
+     *
+     * @return string
+     */
+    protected function convertSurname($string, $dictLoader)
+    {
+        $dictLoader->mapSurname(function ($dictionary) use (&$string) {
+            foreach ($dictionary as $surname => $pinyin) {
+                if (0 === strpos($string, $surname)) {
+                    $string = $pinyin . mb_substr($string, mb_strlen($surname, 'UTF-8'), mb_strlen($string, 'UTF-8') - 1, 'UTF-8');
+
+                    break;
+                }
+            }
+        });
+
+        return $string;
+    }
+
+    /**
+     * Split pinyin string to words.
+     *
+     * @param string $pinyin
+     * @param string $option
+     *
+     * @return array
+     */
+    protected function splitWords($pinyin, $option)
+    {
+        $split = array_filter(preg_split('/\s+/i', $pinyin));
+
+        if (!$this->hasOption($option, PINYIN_TONE)) {
+            foreach ($split as $index => $pinyin) {
+                $split[$index] = $this->formatTone($pinyin, $option);
+            }
+        }
+
+        return array_values($split);
+    }
+
+    /**
+     * @param int $option
+     * @param int $check
+     *
+     * @return bool
+     */
+    public function hasOption($option, $check)
+    {
+        return ($option & $check) === $check;
+    }
+
+    /**
+     * Pre-process.
+     *
+     * @param string $string
+     * @param int    $option
+     *
+     * @return string
+     */
+    protected function prepare($string, $option = \PINYIN_DEFAULT)
+    {
+        $string = preg_replace_callback('~[a-z0-9_-]+~i', function ($matches) {
+            return "\t" . $matches[0];
+        }, $string);
+
+        $regex = ['\x{3007}\x{2E80}-\x{2FFF}\x{3100}-\x{312F}\x{31A0}-\x{31EF}\x{3400}-\x{4DBF}\x{4E00}-\x{9FFF}\x{F900}-\x{FAFF}', '\p{Z}', '\p{M}', "\t"];
+
+        if ($this->hasOption($option, \PINYIN_KEEP_NUMBER)) {
+            \array_push($regex, '0-9');
+        }
+
+        if ($this->hasOption($option, \PINYIN_KEEP_ENGLISH)) {
+            \array_push($regex, 'a-zA-Z');
+        }
+
+        if ($this->hasOption($option, \PINYIN_KEEP_PUNCTUATION)) {
+            $punctuations = array_merge($this->punctuations, ["\t" => ' ', '  ' => ' ']);
+            $string = trim(str_replace(array_keys($punctuations), $punctuations, $string));
+
+            \array_push($regex, preg_quote(implode(array_merge(array_keys($this->punctuations), $this->punctuations)), '~'));
+        }
+
+        return preg_replace(\sprintf('~[^%s]~u', implode($regex)), '', $string);
+    }
+
+    /**
+     * Format.
+     *
+     * @param string $pinyin
+     * @param int    $option
+     *
+     * @return string
+     */
+    protected function formatTone($pinyin, $option = \PINYIN_NO_TONE)
+    {
+        $replacements = [
+            // mb_chr(593) => 'ɑ' 轻声中除了 `ɑ` 和 `ü` 以外，其它和字母一样
+            'ɑ' => ['a', 5], 'ü' => ['yu', 5],
+            'üē' => ['ue', 1], 'üé' => ['ue', 2], 'üě' => ['ue', 3], 'üè' => ['ue', 4],
+            'ā' => ['a', 1], 'ē' => ['e', 1], 'ī' => ['i', 1], 'ō' => ['o', 1], 'ū' => ['u', 1], 'ǖ' => ['yu', 1],
+            'á' => ['a', 2], 'é' => ['e', 2], 'í' => ['i', 2], 'ó' => ['o', 2], 'ú' => ['u', 2], 'ǘ' => ['yu', 2],
+            'ǎ' => ['a', 3], 'ě' => ['e', 3], 'ǐ' => ['i', 3], 'ǒ' => ['o', 3], 'ǔ' => ['u', 3], 'ǚ' => ['yu', 3],
+            'à' => ['a', 4], 'è' => ['e', 4], 'ì' => ['i', 4], 'ò' => ['o', 4], 'ù' => ['u', 4], 'ǜ' => ['yu', 4],
+        ];
+
+        foreach ($replacements as $unicode => $replacement) {
+            if (false !== strpos($pinyin, $unicode)) {
+                $umlaut = $replacement[0];
+
+                // https://zh.wikipedia.org/wiki/%C3%9C
+                if ($this->hasOption($option, \PINYIN_UMLAUT_V) && 'yu' == $umlaut) {
+                    $umlaut = 'v';
+                }
+
+                $pinyin = str_replace($unicode, $umlaut, $pinyin) . ($this->hasOption($option, PINYIN_ASCII_TONE) ? $replacement[1] : '');
+            }
+        }
+
+        return $pinyin;
+    }
+}
--- a/vendor/overtrue/pinyin/src/const.php
+++ b/vendor/overtrue/pinyin/src/const.php
@ -0,0 +1,20 @@
+<?php
+
+/*
+ * This file is part of the overtrue/pinyin.
+ *
+ * (c) overtrue <i@overtrue.me>
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+define('PINYIN_DEFAULT', 4096);
+define('PINYIN_TONE', 2);
+define('PINYIN_NO_TONE', 4);
+define('PINYIN_ASCII_TONE', 8);
+define('PINYIN_NAME', 16);
+define('PINYIN_KEEP_NUMBER', 32);
+define('PINYIN_KEEP_ENGLISH', 64);
+define('PINYIN_UMLAUT_V', 128);
+define('PINYIN_KEEP_PUNCTUATION', 256);