README

一个小型的转写包，可以将西里尔字母转写为其他形式，并允许创建自定义的转写映射表。

• 预置映射表
• 系统要求
• 安装
• 配置
• 使用
• 创建转写映射表
• 创建转换器

预置映射表

• 俄语
  • 默认
  • ГOST 7.79 2000
• 乌克兰语
  • 国家

系统要求

• laravel >= 5.6
• ext-intl

安装

composer require jackmartin/transliterate

从版本 5.5 开始，Laravel 不需要额外的配置，因为有了包发现机制。

如果您不使用包发现，需要注册 Service Provider，将其添加到配置文件 app.php 的 providers 数组中。

ElForastero\Transliterate\ServiceProvider::class,

如果您想使用别名，请将其添加到配置文件 app.php 的 facades 数组中。

建议使用 Transliterate 作为别名，以避免与 Intl 扩展中的 Transliterator 类发生冲突。

'Transliterate' => ElForastero\Transliterate\Facade::class,

配置

将配置文件 transliterate.php 复制到 configs 目录中，执行以下操作：

> php artisan vendor:publish --provider="ElForastero\Transliterate\ServiceProvider"

使用

您可以使用门面来执行转写操作。

use Transliterate;

Transliterate::make('Двадцать тысяч льё под водой');
// "Dvadcat tisyach lyo pod vodoy"

可以将替代的转写映射表作为第二个参数传递。

use ElForastero\Transliterate\Transliterator;

$transliterator = new Transliterator(Map::LANG_RU, Map::GOST_7_79_2000);
$transliterator->make('Двадцать тысяч льё под водой');
// "Dvadcat` ty'syach l`yo pod vodoj"

生成 URL

方法 slugify 生成 URL，移除字符串中的所有标点符号，并将空格替换为 "-".

Transliterate::slugify('Съешь еще этих мягких французских булок, да выпей чаю!');
// sesh-eshhe-etih-myagkih-francuzskih-bulok-da-vipey-chayu

创建转写映射表

每个映射表都是一个关联数组，其中包含要替换的符号作为键，以及它们将被替换的值。

映射表以返回数组的独立文件的形式创建。

// /resources/maps/uk/ukraine.php

return [
    'ї' => 'i',
    'і' => 'i',
    'є' => 'ie',
];

将创建的映射表的路径添加到配置文件 transliterate.php 的 maps 数组中。

'uk' => [
    'ukraine' => dirname(__DIR__) . '/resources/maps/uk/ukraine.php',
]

之后就可以使用该映射表了。

$transliterator = new Transliterator('uk', 'ukraine');
$transliterator->make('Ваша транслітерація');

创建转换器

转换器是将在转写结果上自动应用的功能。如果需要每次对转写字符串执行相同的操作，这非常有用。转换器在 transformers 数组中注册。

例如，可以自动删除末尾的空格。

ElForastero\Transliterate\Transformer::register(\Closure::fromCallable('trim')),

或者将字符串转换为小写。

ElForastero\Transliterate\Transformer::register(\Closure::fromCallable('trim')),
ElForastero\Transliterate\Transformer::register(\Closure::fromCallable('strtolower')),

请注意，转换器将在每次调用 Transliterator::make 时应用。