README

Мультиязычный инфлектор для PHP 8.1+ без зависимостей: пять языков (русский, английский, немецкий, французский, испанский), склонение по падежам и числам, спряжение глаголов по временам, счётная форма, транслитерация кириллица ↔ латиница и автоматическое определение языка.

Установка

composer require cloudcastle/inflector

Требуется PHP 8.1+. Runtime-зависимостей нет (zero-dependency).

Быстрый старт

<?php

use CloudCastle\Inflector\Inflector;
use CloudCastle\Inflector\Language;
use CloudCastle\Inflector\GrammaticalCase;
use CloudCastle\Inflector\GrammaticalNumber;
use CloudCastle\Inflector\Tense;
use CloudCastle\Inflector\Person;

// Авто-определение языка по каждому слову (язык не задан)
$inflector = new Inflector();
$inflector->pluralize('стол');       // 'столы'
$inflector->pluralize('category');   // 'categories'
$inflector->singularize('châteaux'); // 'château'

// Фиксированный язык (быстрее: без детекта)
$ru = new Inflector(Language::Russian);

// Склонение по падежам и числам
$ru->decline('стол', GrammaticalCase::Genitive);                            // 'стола'
$ru->decline('стол', GrammaticalCase::Dative, GrammaticalNumber::Plural);   // 'столам'

// Счётная форма: 1 товар / 2 товара / 5 товаров
$ru->pluralizeByCount('товар', 1);   // 'товар'
$ru->pluralizeByCount('товар', 2);   // 'товара'
$ru->pluralizeByCount('товар', 5);   // 'товаров'

// Спряжение по временам, лицам и числам
$ru->conjugate('работать', Tense::Past);                  // 'работал'
$ru->conjugate('работать', Tense::Present, Person::First); // 'работаю'
$ru->conjugate('работать', Tense::Future);                // 'будет работать'

// Транслитерация и слаги
$inflector->toLatin('щука');            // 'shchuka'
$inflector->toCyrillic('privet');       // 'привет'
$inflector->transliterate('привет');    // 'privet' (направление — автоматически)
$inflector->slugify('Привет мир');      // 'privet-mir'

// Определение языка
$inflector->detectLanguage('mañana');   // Language::Spanish

// Форматы имён для ORM/API
$inflector->tableize('UserAccount');    // 'user_accounts'
$inflector->classify('user_accounts'); // 'UserAccount'
$inflector->camelize('foo_bar');        // 'fooBar'

Возможности

• Пять языков — русский, английский, немецкий, французский, испанский; единый API и контракт правил (LanguageRulesInterface) для добавления новых языков.
• Число существительных — pluralize/singularize с нерегулярными парами и неисчисляемыми словами каждого языка; счётная форма pluralizeByCount (1 товар / 2 товара / 5 товаров).
• Склонение — 6 русских падежей в обоих числах (регулярные парадигмы 1/2/3 склонения и среднего рода), немецкие Genitiv и Dativ Plural.
• Спряжение — прошедшее, настоящее и будущее время по лицам и числам: регулярные парадигмы всех пяти языков + частотные нерегулярные английские глаголы.
• Транслитерация — кириллица → латиница и латиница → кириллица (практическая схема, многобуквенные сочетания shch/zh/yo), автонаправление по алфавиту.
• Определение языка — по алфавиту, диакритике (ß/ü, ñ, ç/œ) и частотным служебным словам; опция конструктора: авто-режим или фиксированный язык.
• Форматы имён — camelize/pascalize/underscore/tableize/classify/ dasherize/titleize/humanize, слаги с транслитерацией, порядковые числительные по правилам языка (1-й, 1st, 1., 1er, 1.º).
• Расширяемость — пользовательские нерегулярные пары, неисчисляемые слова и regex-правила per-язык.
• Производительность — ограниченные (bounded) кэши всех горячих путей: O(1) на повторяющемся вводе без неограниченного роста памяти.

Функционально пакет покрывает возможности сравниваемых аналогов вместе взятых: doctrine/inflector, symfony/string (инфлекторы), wapmorgan/morphos, ext-intl.

Возможности против аналогов

Сводная таблица (генерируется автоматически из tools/features-data.php; значения выверены по коду и документации аналогов). Легенда: ✅ полностью · ⚠️ частично · 🔌 адаптер · ❌ нет · — неприменимо.

Сгенерировано из tools/features-data.php (факты о поддержке). Легенда: ✅ полностью · ⚠️ частично · 🔌 адаптер · ❌ нет · — неприменимо.

Языки

Число существительных

Склонение и спряжение

Транслитерация

Форматы имён (ORM/API)

Расширяемость

Производительность и нагрузка

Безопасность и качество

Производительность

Изолированные замеры без Xdebug (composer compare), эквивалентные операции. Метрика — ops/sec (больше — лучше); «—» — операция не поддерживается.

Сгенерировано из composer compare (PHP 8.1.34). Правки в блоке будут перезаписаны.

Полное сравнение по каждой возможности — в Wiki: Сравнение.

Заключение: когда что выбирать

Сильные стороны cloudcastle/inflector — единственный PHP-пакет, объединяющий инфлексию пяти языков, склонение по падежам, спряжение по временам, счётную форму, транслитерацию и автоопределение языка — при нуле runtime-зависимостей. Все горячие пути работают с ограниченной памятью (bounded-кэши со сбросом), любой «грязный» ввод обрабатывается fail-safe (данные, не код), мутационное покрытие — Infection MSI 100 %.

Производительность: победитель во всех девяти сценариях сравнения — от английской плюрализации (быстрее doctrine/inflector в ~1.2×) до русской морфологии (быстрее wapmorgan/morphos в ~10–170×) и транслитерации (быстрее ext-intl ICU в ~270×). Замеры изолированные, без Xdebug (composer compare).

Слабые стороны — морфология построена на регулярных парадигмах без полного словаря: одушевлённость русских существительных не определяется (винительный падеж неодушевлённый), слова на «-ь» склоняются по женскому 3-му склонению, нерегулярные глаголы (кроме частотных английских) спрягаются только по регулярным схемам. Для задач, где нужна словарная точность каждой формы, используйте морфологический анализатор с полным словарём.

Честные рекомендации:

• Мультиязычное приложение (интерфейсы, счётчики, URL, ORM) — cloudcastle/inflector.
• Только английская инфлексия в Doctrine-проекте — doctrine/inflector уже в зависимостях ORM.
• Только английское/французское число в Symfony — symfony/string уже в фреймворке.
• Русская морфология со словарной точностью (имена, отчества, географические названия) — wapmorgan/morphos.
• Транслитерация экзотических письменностей (не кириллица) — ext-intl (ICU).

Документация

• Wiki — руководство пользователя
• Быстрый старт
• Возможности (Features)
• Сравнение с аналогами
• Архитектура
• API-документация

Качество

Пакет придерживается production-стандартов: строгая типизация, полный статический анализ (PHPStan max, Psalm level 1, PHPMD, Deptrac, Rector), покрытие тестами 100 % на каждый файл и мутационное тестирование (Infection MSI 100 %). Матрица CI — PHP 8.1–8.5.

composer ci        # полный пайплайн качества
composer check     # быстрые проверки перед коммитом
composer test      # тесты (unit + integration + security + load + performance)
composer compare   # сравнение производительности с аналогами

Контакты

• Email — alex-4-17@yandex.ru
• VK — https://vk.com/leha_zorin
• Telegram — @CloudCastle85
• Телефон — +79872763991
• Сетка — https://set.ki/LdYRz76

Поддержать проект

Реквизиты для поддержки автора — в DONATE.md.

Contributors

Спасибо всем, кто вносит вклад в проект:

Список ведётся по спецификации all-contributors.

Лицензия

MIT © CloudCastle