Download the PHP package elforastero/transliterate without Composer
On this page you can find all versions of the php package elforastero/transliterate. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download elforastero/transliterate
More information about elforastero/transliterate
Files in elforastero/transliterate
Package transliterate
Short Description Transliteration package for laravel
License MIT
Informations about the package transliterate
Transliterate
Небольшой пакет для транслитерации кириллицы с возможностью создания своих собственных карт транслитерации.
- Предустановленные карты
- Системные требования
- Установка
- Конфигурация
- Использование
- Создание карт транслитерации
- Создание трансформеров
Предустановленные карты
- Русский
- Дефолтная
- ГОСТ 7.79 2000
- Украинский
- Национальная
Системные требования
- laravel >= 5.6
- ext-intl
Установка
⚠️ Для Laravel v5 используйте ветку v2:
composer require elforastero/transliterate "^2.0"
Laravel начиная с версии 5.5 не нуждается в дополнительной конфигурации благодаря механизму Package Discovery.
Если вы не используте Package Discovery, необходимо зарегистрировать Service Provider
, добавив его в массив providers
, конфигурационного файла app.php
.
Если вы хотите использовать алиас, добавьте его в массив facades
в app.php
.
Рекомендую в качестве алиаса использовать Transliterate
, чтобы избежать конфликтов с Transliterator классом из расширения Intl.
Конфигурация
Для копирования конфига transliterate.php
в директорию configs
выполните
Использование
Вы можете использовать фасад для транслитерации строк.
Альтернативная карта транслитерации может быть передана вторым параметром.
Генерация URL
Метод slugify
генерирует URL, убирая из строки все знаки препинания и заменяя пробелы на "-".
Создание карт транслитерации
Каждая карта представляет собой ассоциативный массив с символами подлежащими замене в качестве ключей, и значениями на которые они будут заменены.
Карта создается в виде отдельного файла с возвращаемым массивом:
Добавьте путь к созданной карте в массив maps
, конфига transliterate.php
:
После этого карту можно использовать.
Создание трансформеров
Трансформеры - функции которые будут автоматически применены к результату транслитерации. Полезно если вам необходимо каждый раз производить одни и те же действия с транслитерируемой строкой. Регистрируется трансформер в массиве transformers
.
Например, можно автоматечески убирать конечные пробелы.
Или дополнительно приводить строки к нижнему регистру.
Будьте внимательны, поскольку трансформеры применяются при каждом вызове
Transliterator::make
.
Разработка
Для прогона PHPUnit тестов можно воспользоваться лежащим в корне Dockerfile:
All versions of transliterate with dependencies
ext-intl Version *
illuminate/support Version ^6.0|^7.0|^8.0|^9.0|^10.0|^11.0