96 lines
3.4 KiB
PHP
96 lines
3.4 KiB
PHP
|
<?php
|
|||
|
|
|
|||
|
|
namespace Overtrue\Pinyin;
|
|||
|
|
|
|||
|
|
use InvalidArgumentException;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @method static Converter surname()
|
|||
|
|
* @method static Converter noWords()
|
|||
|
|
* @method static Converter onlyHans()
|
|||
|
|
* @method static Converter noAlpha()
|
|||
|
|
* @method static Converter noNumber()
|
|||
|
|
* @method static Converter noPunctuation()
|
|||
|
|
* @method static Converter noTone()
|
|||
|
|
* @method static Converter useNumberTone()
|
|||
|
|
* @method static Converter yuToV()
|
|||
|
|
* @method static Converter yuToU()
|
|||
|
|
* @method static Converter polyphonic(bool $asList = false)
|
|||
|
|
* @method static Converter withToneStyle(string $toneStyle = 'symbol')
|
|||
|
|
* @method static Collection convert(string $string, callable $beforeSplit = null)
|
|||
|
|
*/
|
|||
|
|
class Pinyin
|
|||
|
|
{
|
|||
|
|
public static function name(string $name, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
|
|||
|
|
{
|
|||
|
|
return self::surname()->withToneStyle($toneStyle)->convert($name);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function passportName(string $name, string $toneStyle = Converter::TONE_STYLE_NONE): Collection
|
|||
|
|
{
|
|||
|
|
return self::surname()->yuToYu()->withToneStyle($toneStyle)->convert($name);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function phrase(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
|
|||
|
|
{
|
|||
|
|
return self::noPunctuation()->withToneStyle($toneStyle)->convert($string);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function sentence(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
|
|||
|
|
{
|
|||
|
|
return self::withToneStyle($toneStyle)->convert($string);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function polyphones(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL, bool $asList = false): Collection
|
|||
|
|
{
|
|||
|
|
return self::polyphonic($asList)->withToneStyle($toneStyle)->convert($string);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function polyphonesAsArray(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
|
|||
|
|
{
|
|||
|
|
return self::polyphones($string, $toneStyle, true);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function chars(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
|
|||
|
|
{
|
|||
|
|
return self::onlyHans()->noWords()->withToneStyle($toneStyle)->convert($string);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function permalink(string $string, string $delimiter = '-'): string
|
|||
|
|
{
|
|||
|
|
if (! in_array($delimiter, ['_', '-', '.', ''], true)) {
|
|||
|
|
throw new InvalidArgumentException("Delimiter must be one of: '_', '-', '', '.'.");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return self::noPunctuation()->noTone()->convert($string)->join($delimiter);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function nameAbbr(string $string): Collection
|
|||
|
|
{
|
|||
|
|
return self::abbr($string, true);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function abbr(string $string, bool $asName = false): Collection
|
|||
|
|
{
|
|||
|
|
return self::noTone()
|
|||
|
|
->noPunctuation()
|
|||
|
|
->when($asName, fn ($c) => $c->surname())
|
|||
|
|
->convert($string)
|
|||
|
|
->map(function ($pinyin) {
|
|||
|
|
// 常用于电影名称入库索引处理，例如：《晚娘2012》-> WN2012
|
|||
|
|
return \is_numeric($pinyin) || preg_match('/\d{2,}/', $pinyin) ? $pinyin : \mb_substr($pinyin, 0, 1);
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public static function __callStatic(string $name, array $arguments)
|
|||
|
|
{
|
|||
|
|
$converter = Converter::make();
|
|||
|
|
|
|||
|
|
if (\method_exists($converter, $name)) {
|
|||
|
|
return $converter->$name(...$arguments);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
throw new InvalidArgumentException("Method {$name} does not exist.");
|
|||
|
|
}
|
|||
|
|
}
|