PHPackages digit-soft/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. digit-soft/transliterate ActiveLibrary[Utility & Helpers](/categories/utility) digit-soft/transliterate ======================== Transliteration package for Laravel 10.0.0(3mo ago)025MITPHPPHP ^8.2CI failing Since Apr 8Pushed 3mo agoCompare [ Source](https://github.com/digit-soft/transliterate)[ Packagist](https://packagist.org/packages/digit-soft/transliterate)[ RSS](/packages/digit-soft-transliterate/feed)WikiDiscussions master Synced 1w ago READMEChangelog (1)Dependencies (5)Versions (2)Used By (0) Transliterate ------------- [](#transliterate) Невеликий пакет для транслітерації кирилиці з можливістю створення власних карт транслітерації. - [Попередньо встановлені карти](#%D0%9F%D0%BE%D0%BF%D0%B5%D1%80%D0%B5%D0%B4%D0%BD%D1%8C%D0%BE-%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D1%96-%D0%BA%D0%B0%D1%80%D1%82%D0%B8) - [Системні вимоги](#%D0%A1%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%BD%D1%96-%D0%B2%D0%B8%D0%BC%D0%BE%D0%B3%D0%B8) - [Встановлення](#%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F) - [Конфігурація](#%D0%9A%D0%BE%D0%BD%D1%84%D1%96%D0%B3%D1%83%D1%80%D0%B0%D1%86%D1%96%D1%8F) - [Використання](#%D0%92%D0%B8%D0%BA%D0%BE%D1%80%D0%B8%D1%81%D1%82%D0%B0%D0%BD%D0%BD%D1%8F) - [Створення карт транслітерації](#%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F-%D0%BA%D0%B0%D1%80%D1%82-%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BB%D1%96%D1%82%D0%B5%D1%80%D0%B0%D1%86%D1%96%D1%97) - [Створення трансформерів](#%D0%A1%D1%82%D0%B2%D0%BE%D1%80%D0%B5%D0%BD%D0%BD%D1%8F-%D1%82%D1%80%D0%B0%D0%BD%D1%81%D1%84%D0%BE%D1%80%D0%BC%D0%B5%D1%80%D1%96%D0%B2) Попередньо встановлені карти ---------------------------- [](#попередньо-встановлені-карти) - Українська - Національна - Російська - Дефолтна - ГОСТ 7.79 2000 Системні вимоги --------------- [](#системні-вимоги) - laravel >= 9.0 - ext-intl Встановлення ------------ [](#встановлення) ``` > composer require digit-soft/transliterate ``` Якщо ви хочете використовувати аліас, додайте його в масив `facades` в `app.php`. Рекомендую як аліас використовувати `Transliterate`, щоб уникнути конфліктів з класом `Transliterator` з розширення `Intl`. ``` 'Transliterate' => DigitSoft\Transliterate\Facade::class, ``` Конфігурація ------------ [](#конфігурація) Для копіювання конфігу `transliterate.php` в директорію `configs` виконайте: ``` > php artisan vendor:publish --provider="DigitSoft\Transliterate\ServiceProvider" ``` Використання ------------ [](#використання) Ви можете використовувати фасад для транслітерації рядків. ``` use Transliterate; Transliterate::make('Двадцять тисяч льє під водою'); // "Dvadtsyat tysyach lie pid vodoiu" ``` Альтернативна карта транслітерації може бути передана другим параметром. ``` use DigitSoft\Transliterate\Transliterator; $transliterator = new Transliterator(Map::LANG_UK, Map::DEFAULT); $transliterator->make('Двадцять тисяч льє під водою'); // "Dvadtsyat tysyach lie pid vodoiu" ``` Генерація URL ------------- [](#генерація-url) Метод `slugify` генерує URL, видаляючи з рядка всі розділові знаки та замінюючи пробіли на "-". ``` Transliterate::slugify('Жебракують філософи при ґанку церкви в Гадячі, ще й шатро розклали!'); // zhebrakuiut-filosofy-pry-ganku-tserkvy-v-hadyachi-shche-i-shatro-rozklaly ``` Створення карт транслітерації ----------------------------- [](#створення-карт-транслітерації) Кожна карта являє собою асоціативний масив із символами, що підлягають заміні, у якості ключів, та значеннями, на які вони будуть замінені. Карта створюється у вигляді окремого файлу з масивом, що повертається: ``` // /resources/maps/uk/ukrainian-v2.php return [ 'ї' => 'i', 'і' => 'i', 'є' => 'ie', ]; ``` Додайте шлях до створеної карти в масив `maps` конфігу `transliterate.php`: ``` 'ua' => [ 'ukraine' => dirname(__DIR__) . '/resources/maps/uk/ukrainian-v2.php', ] ``` Після цього карту можна використовувати. ``` $transliterator = new Transliterator('ua', 'ukrainian-v2'); $transliterator->make('Ваша транслітерація'); ``` Створення трансформерів ----------------------- [](#створення-трансформерів) Трансформери - функції, які будуть автоматично застосовані до результату транслітерації. Корисно, якщо вам необхідно щоразу виконувати одні й ті самі дії з рядком, що транслітерується. Реєструється трансформер у масиві `transformers`. Наприклад, можна автоматично прибирати кінцеві пробіли. ``` DigitSoft\Transliterate\Transformer::register(\Closure::fromCallable('trim')), ``` Або додатково приводити рядки до нижнього регістру. ``` DigitSoft\Transliterate\Transformer::register(\Closure::fromCallable('trim')), DigitSoft\Transliterate\Transformer::register(\Closure::fromCallable('strtolower')), ``` > Будьте уважні, оскільки трансформери застосовуються при кожному виклику `Transliterator::make`. ### Розробка [](#розробка) Для прогону PHPUnit тестів можна скористатися Dockerfile, що лежить у корені: ``` docker-compose up --build ... php_1 | Runtime: PHP 8.0.22 php_1 | Configuration: /srv/app/phpunit.xml php_1 | php_1 | ..... 5 / 5 (100%) php_1 | php_1 | Time: 00:00.959, Memory: 14.00 MB php_1 | php_1 | OK (5 tests, 6 assertions) ``` ### Health Score 38 — LowBetter than 83% of packages Maintenance80 Actively maintained with recent releases Popularity8 Limited adoption so far Community12 Small or concentrated contributor base Maturity46 Maturing project, gaining track record Bus Factor1 Top contributor holds 85.3% 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 Unknown Total 1 Last Release 107d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/11768817?v=4)[Volodymyr Kovalenko](/maintainers/digitv)[@digitv](https://github.com/digitv) --- Top Contributors [![ElForastero](https://avatars.githubusercontent.com/u/5102818?v=4)](https://github.com/ElForastero "ElForastero (64 commits)")[![digitv](https://avatars.githubusercontent.com/u/11768817?v=4)](https://github.com/digitv "digitv (4 commits)")[![dotzero](https://avatars.githubusercontent.com/u/265633?v=4)](https://github.com/dotzero "dotzero (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![alexprowars](https://avatars.githubusercontent.com/u/5769583?v=4)](https://github.com/alexprowars "alexprowars (1 commits)")[![Balerka](https://avatars.githubusercontent.com/u/78909936?v=4)](https://github.com/Balerka "Balerka (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/digit-soft-transliterate/health.svg) ``` [![Health](https://phpackages.com/badges/digit-soft-transliterate/health.svg)](https://phpackages.com/packages/digit-soft-transliterate) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3345.3M347](/packages/psalm-plugin-laravel)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)