dictpedia/zhuyin-pinyin

A PHP library that deals with Zhuyin to Pinyin and Pinyin to Zhuyin.

ZhuyinPinyin

A PHP library that deals with Zhuyin (注音) to Pinyin (漢語拼音), Pinyin to Zhuyin., _(*1)

https://github.com/localvar/zhuyin (Golang version), _(*2)

The original idea is from a Golang library written by Bomin Zhang, I recoding it with PHP and using on DictPedia project., _(*3)

For example, this library will translate zhang1 to zhāng (pinyin) or ㄓㄤ (zhuyin), zhāng or ㄓㄤ decode to zhang1, and also support pinyin to zhuyin and zhuyin to pinyin., _(*4)

這個函式庫的原始邏輯設計出自以 Golang 編寫，因為本人需要用在字典百科專案中，但尋無以 PHP 版本實現的注音轉拼音、拼音轉注音的函式庫，所以我把它從 Golang 改寫成 PHP 版本。, _(*5)

• 此PHP 版與 Golang 原版的差別是捨棄字串陣列，分別讀取個別字元進去陣列以避免可能的 UTF-8字元問題
• 原始邏輯已經處理的很好了，所以直接移植為 PHP 版本。只加了一個函式 splitString 來處理個別 UTF-8 字元

Install

composer require dictpedia/zhuyin-pinyin

Usage

$zh = new \DictPedia\ZhuyinPinyin();

Resutn empty string if the input string is invaild., _(*6)

API

encodePinyin

echo $zh->encodePinyin('zhang1');

// result: zhāng

decodePinyin

echo $zh->decodePinyin('zhāng');

// result: zhang1

encodeZhuyin

echo $zh->encodeZhuyin('zhang1');

// result: ㄓㄤ

decodeZhuyin

echo $zh->decodeZhuyin('ㄓㄤ');

// result: zhang1

pinyinToZhuyin

echo $zh->pinyinToZhuyin('zhāng');

// result: ㄓㄤ

zhuyinToPinyin

echo $zh->zhuyinToPinyin('ㄓㄤ');

// result: zhāng

License

MIT, _(*7)

https://packagist.org/packages/dictpedia/zhuyin-pinyin, _(*8)