PHPackages                             victord11/transliterate - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. victord11/transliterate

ActiveLibrary[Utility & Helpers](/categories/utility)

victord11/transliterate
=======================

Transliteration package for laravel

6.5.0(5mo ago)110.5kMITPHPPHP ^8.1

Since Feb 4Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/VictoRD11/Transliterate)[ Packagist](https://packagist.org/packages/victord11/transliterate)[ RSS](/packages/victord11-transliterate/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (5)Versions (16)Used By (0)

Transliterate
-------------

[](#transliterate)

[![GitHub](https://camo.githubusercontent.com/850eae1099d2b05f53383473d7cd51f9bc1ab09b7d0d9e5122f1dd930efdcc6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6173686170652f6170697374617475732e737667)](https://camo.githubusercontent.com/850eae1099d2b05f53383473d7cd51f9bc1ab09b7d0d9e5122f1dd930efdcc6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6173686170652f6170697374617475732e737667)[![GitHub release](https://camo.githubusercontent.com/c29eedc84633f71c9b9c3640bb67c788a3ea53ee32794e10fe933e9794da514b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f766963746f726431312f7472616e736c697465726174652e737667)](https://camo.githubusercontent.com/c29eedc84633f71c9b9c3640bb67c788a3ea53ee32794e10fe933e9794da514b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f766963746f726431312f7472616e736c697465726174652e737667)[![Packagist](https://camo.githubusercontent.com/db73d7b41c11eabc53b763d1779b8b657ed45bb7375ecd5bd887b88dbe6ffbf3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766963746f726431312f7472616e736c697465726174652e737667)](https://camo.githubusercontent.com/db73d7b41c11eabc53b763d1779b8b657ed45bb7375ecd5bd887b88dbe6ffbf3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766963746f726431312f7472616e736c697465726174652e737667)

Небольшой пакет для транслитерации кириллицы с возможностью создания своих собственных карт транслитерации.

[![Code example](example.png)](example.png)

- [Предустановленные карты](#%D0%9F%D1%80%D0%B5%D0%B4%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5-%D0%BA%D0%B0%D1%80%D1%82%D1%8B)
- [Системные требования](#%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%8B%D0%B5-%D1%82%D1%80%D0%B5%D0%B1%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)
- [Установка](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)
- [Конфигурация](#%D0%9A%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F)
- [Использование](#%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)
- [Создание карт транслитерации](#%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BA%D0%B0%D1%80%D1%82-%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BB%D0%B8%D1%82%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8)
- [Создание трансформеров](#%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%82%D1%80%D0%B0%D0%BD%D1%81%D1%84%D0%BE%D1%80%D0%BC%D0%B5%D1%80%D0%BE%D0%B2)

Предустановленные карты
-----------------------

[](#предустановленные-карты)

- Русский
    - Дефолтная
    - ГОСТ 7.79 2000
- Украинский
    - Национальная

Системные требования
--------------------

[](#системные-требования)

- laravel >= 5.6

Установка
---------

[](#установка)

```
> composer require victord11/transliterate

```

> ⚠️ Для Laravel v5 используйте ветку v3: `composer require victord11/transliterate "^3.0"`

> ⚠️ Для Laravel v6 используйте ветку v4: `composer require victord11/transliterate "^4.0"`

> ⚠️ Для Laravel v7 используйте ветку v5: `composer require victord11/transliterate "^5.0"`

> ⚠️ Для Laravel v8,v9,v10,v11, v12 используйте ветку v6: `composer require victord11/transliterate "^6.0"`

Laravel начиная с версии *5.5* не нуждается в дополнительной конфигурации благодаря механизму Package Discovery.

Если вы не используте Package Discovery, необходимо зарегистрировать `Service Provider`, добавив его в массив `providers`, конфигурационного файла `app.php`.

```
VictoRD11\Transliterate\ServiceProvider::class,
```

Если вы хотите использовать алиас, добавьте его в массив `facades` в `app.php`.

Рекомендую в качестве алиаса использовать `Transliterate`, чтобы избежать конфликтов с Transliterator классом из расширения Intl.

```
'Transliterate' => VictoRD11\Transliterate\Facade::class,
```

Конфигурация
------------

[](#конфигурация)

Для копирования конфига `transliterate.php` в директорию `configs` выполните

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

```

Использование
-------------

[](#использование)

Вы можете использовать фасад для транслитерации строк.

```
use Transliterate;

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

Альтернативная карта транслитерации может быть передана вторым параметром.

```
use VictoRD11\Transliterate\Transliterator;

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

Генерация URL
-------------

[](#генерация-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`.

Например, можно автоматечески убирать конечные пробелы.

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

Или дополнительно приводить строки к нижнему регистру.

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

> Будьте внимательны, поскольку трансформеры применяются при каждом вызове `Transliterator::make`.

###  Health Score

49

—

FairBetter than 95% of packages

Maintenance70

Regular maintenance activity

Popularity21

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 79.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~267 days

Recently: every ~433 days

Total

13

Last Release

174d ago

Major Versions

1.1.0 → 2.0.02018-12-08

2.0.1 → 3.0.02019-06-10

3.0.0 → 4.0.02021-02-16

4.0.0 → 5.0.02021-02-16

5.0.0 → 6.0.02021-02-16

PHP version history (6 changes)2.0.0PHP >=7.1

4.0.0PHP >=7.2

6.0.0PHP ^7.4|^8.0

6.1.0PHP ^7.3|^8.0

6.3.0PHP ^8.0

6.4.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/b2ab046812456439266721ae8bb426e4c0c107be552f30ac022e6927eca4c8c5?d=identicon)[VictoRD11](/maintainers/VictoRD11)

---

Top Contributors

[![ElForastero](https://avatars.githubusercontent.com/u/5102818?v=4)](https://github.com/ElForastero "ElForastero (38 commits)")[![VictoRD11](https://avatars.githubusercontent.com/u/311195?v=4)](https://github.com/VictoRD11 "VictoRD11 (10 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/victord11-transliterate/health.svg)

```
[![Health](https://phpackages.com/badges/victord11-transliterate/health.svg)](https://phpackages.com/packages/victord11-transliterate)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M686](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M157](/packages/orchestra-canvas)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M211](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M862](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)