jackmartin / transliterate
Transliteration package
Requires
- php: >=7.1
- ext-intl: *
- illuminate/support: ^5.5 || ^6.0 || ^7.0 || ^8.0
Requires (Dev)
- brainmaestro/composer-git-hooks: ^2.8
- friendsofphp/php-cs-fixer: ^2.16
- orchestra/testbench: ^4.4
- phpunit/phpunit: ^8.0
This package is auto-updated.
Last update: 2024-10-08 22:56:22 UTC
README
Небольшой пакет для транслитерации кириллицы с возможностью создания своих собственных карт транслитерации.
- Предустановленные карты
- Системные требования
- Установка
- Конфигурация
- Использование
- Создание карт транслитерации
- Создание трансформеров
Предустановленные карты
- Русский
- Дефолтная
- ГОСТ 7.79 2000
- Украинский
- Национальная
Системные требования
- laravel >= 5.6
- ext-intl
Установка
composer require jackmartin/transliterate
Laravel начиная с версии 5.5 не нуждается в дополнительной конфигурации благодаря механизму Package Discovery.
Если вы не используте Package Discovery, необходимо зарегистрировать Service Provider
, добавив его в массив providers
, конфигурационного файла app.php
.
ElForastero\Transliterate\ServiceProvider::class,
Если вы хотите использовать алиас, добавьте его в массив facades
в app.php
.
Рекомендую в качестве алиаса использовать Transliterate
, чтобы избежать конфликтов с Transliterator классом из расширения Intl.
'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', ];
Добавьте путь к созданной карте в массив maps
, конфига transliterate.php
:
'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
.