## 安裝 `composer require "overtrue/pinyin:~4.0"` ## 使用 ~~~ 可選轉換方案： - 內存型，適用于服務器內存空間較富余，優點：轉換快 $type=1 - 小內存型(默認)，適用于內存比較緊張的環境，優點：占用內存小，轉換不如內存型快 $type=2 - I/O型，適用于虛擬機，內存限制比較嚴格環境。優點：非常微小內存消耗。缺點：轉換慢，不如內存型轉換快,php >= 5.5 $type=3 ~~~ ### 拼音數組使用 ~~~ // 小內存型 Pinyin::instance(1)->convert('帶著希望去旅行，比到達終點更美好'); // ["dai", "zhe", "xi", "wang", "qu", "lyu", "xing", "bi", "dao", "da", "zhong", "dian", "geng", "mei", "hao"] Pinyin::instance(1)->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::instance(1)->convert('帶著希望去旅行，比到達終點更美好', PINYIN_ASCII_TONE); //["dai4","zhe","xi1","wang4","qu4","lyu3","xing2","bi3","dao4","da2","zhong1","dian3","geng4","mei3","hao3"] ~~~ ### 生成用于鏈接的拼音字符串 ```php Pinyin::instance(1)->permalink('帶著希望去旅行'); // dai-zhe-xi-wang-qu-lyu-xing Pinyin::instance(1)->permalink('帶著希望去旅行', '.'); // dai.zhe.xi.wang.qu.lyu.xing ``` ### 獲取首字符字符串 ```php Pinyin::instance(1)->abbr('帶著希望去旅行'); // dzxwqlx Pinyin::instance(1)->abbr('帶著希望去旅行', '-'); // d-z-x-w-q-l-x Pinyin::instance(1)->abbr('你好2018！', PINYIN_KEEP_NUMBER); // nh2018 Pinyin::instance(1)->abbr('Happy New Year! 2018！', PINYIN_KEEP_ENGLISH); // HNY2018 ``` ### 翻譯整段文字為拼音 將會保留中文字符：`，。 ！ ？ ： “ ” ‘ ’` 并替換為對應的英文符號。 ```php Pinyin::instance(1)->sentence('帶著希望去旅行，比到達終點更美好！'); // dai zhe xi wang qu lyu xing, bi dao da zhong dian geng mei hao! Pinyin::instance(1)->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::instance(1)->name('單某某'); // ['shan', 'mou', 'mou'] Pinyin::instance(1)->name('單某某', PINYIN_TONE); // ["shàn","mǒu","mǒu"] ``` ~~~