NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4392 most downloaded on Packagist
A morphological solution for Russian and English language written completely in PHP. Provides classes to inflect personal names, geographical names, decline and pluralize nouns, generate cardinal and ordinal numerals, spell out money amounts and time.
Latest stable
3.2.30
Last release 1 years ago
27 Jun 2025
Release timing varies
gaps range from 2 weeks to 1.9 years
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
65 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Исправление предлога "с" со словами на "с" ( #144 , #145 by @evg555 )
Fixed in Russian:
"с" со словами на "с" (#144, #145 by @evg555)"-сь" (#162 by @doiftrue)"-ия" (#164 by @amashkarin)Enhancements in Russian:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added docker image kind of distribution.
Fixed #122
Fixed #122
Fixes for 8.1: #126 code style #129 ( @sax0n0xas )
Fixed #118 - Russian preposition "in"
Standard unit spelling for Russian
Standard unit spelling for Russian
Specified types of class members, variables, parameters, code style
TimeSpeller::spellDifference()Russian:
яя (#94)Санкт-Перербург, Алма-Ата)ня, еяДобавлен локативный падеж в склонение географических названий: GeographicalNamesInflection::getCase('Крым', Cases::LOCATIVE)
In Russian:
GeographicalNamesInflection::getCase('Крым', Cases::LOCATIVE) (#72)N район, N волость (#70);Кривуша (#71)-аидаИсправлена ошибка генерации числительных для 40
Russian:
-ш (#59)-их и -га (#65)MoneySpeller::spell(123.45, MoneySpeller::RUBLE, MoneySpeller::NORMAL_FORMAT, 'родительный')
Added formatter date & time difference with now: \morphos\English\TimeSpeller::spellDifference($time). $time should be a DateTime instance, a string w
English:
\morphos\English\TimeSpeller::spellDifference($time). $time should be a DateTime instance, a string with date&time or unix timestamp (int).Russian:
\morphos\Russian\TimeSpeller::spellDifference($time). $time должно быть объектом DateTime, строкой с датой/временем или unix timestamp.Исправлено склонение некоторые географических названий (#53, #54, #55, #56)
Russian:
Добавлено склонение прилагательных: morphos\Russian\AdjectivesDeclension
Russian:
morphos\Russian\AdjectivesDeclensionmorphos\Russian\AdjectivesPluralizationmorphos\Russian\pluralize()morphos\Russian\pluralize(10, 'новый дом')
даёт10 новых домов
Исправлено склонение в предложном падеже названий, оканчивающихся на "р": Краснодар
Russian:
КраснодарДобавлена возможность указать падеж при плюрализации существительного (#42 NounPluralization::pluralize('цвет', 7, false, 'prepositional');).
Russian:
NounPluralization::pluralize('цвет', 7, false, 'prepositional');).Орел.Исправлено склонение некоторых существительных.
Russian:
Removed setting process-wide encoding via mb_internal_encoding() or iconv_set_encoding. Now Morphos uses internal encoding without influence on PHP se
mb_internal_encoding() or iconv_set_encoding. Now Morphos uses internal encoding without influence on PHP settings.
If you pass non-unicode (utf-8) strings in Morphos, set encoding before usage via \morphos\S::setEncoding($encoding).mbstring.Russian:
RussianLanguage::verb(), не оканчивающегося на л.-ика.Добавлена обработка слов "район", "поселок", "округ", "республика" в GeographicalNamesInflection.
Russian:
GeographicalNamesInflection.шь (Россошь), ы (Чебоксары), ль (Электросталь), топонимов с бегающими гласными (Орёл).NounDeclension и NounPluralization.Обновлён метод FirstNamesInflection::isMutable(): добавлено больше правил.
Russian:
FirstNamesInflection::isMutable(): добавлено больше правил.песо, гривна, юань).-чь, -рь (Керчь, Анадырь).MoneySpeller::spell(): если дробная часть отсутствует, то она не указывается. (0 копеек и т.п.).General:
S::findLastPosition()Обновлены правила склонения неизменяемых мужских имён.
Russian:
Саша, Пётр.detectGender() при передаче только имени.Исправлено склонение сложных географических названий через пробел, - и -на: Ростов-на-Дону, Переславль-Залесский.
Русский:
- и -на: Ростов-на-Дону, Переславль-Залесский.хутор N, пгт N в склонение.TimeSpeller::spellInterval($interval, $modifiers, 2) - сгенерирует максимум две фразы для интервала, например 5 лет и 2 дня.Поддержка словосочетаний село N в GeographicalNamesInflection
Русский:
село N в GeographicalNamesInflectiongetNameCases($fullName, $gender = null) для получения всех форм имениinflectName() добавлена возможность передавать только имя.Исправлена генерация творительного падежа городов на ов: Киров, Псков, Тамбов (thanks to @VitalyArt)
Russian:
ов: Киров, Псков, Тамбов (thanks to @VitalyArt)Исправлено склонение города Ростов-на-Дону
Russian:
Ростов-на-Донуванная во множественное число (раньше была проблема с количеством 2 и 3).morphos\Russian\pluralize() и метод morphos\Russian\NounPluralization::pluralize() могут принимать аргументы (кол-во предметов и название предмета) в любом порядке. Следующие вызовы равнозначны:morphos\Russian\pluralize(5, 'дом')
morphos\Russian\pluralize('дом', 5)
-ек.Добавлена обработка слов город, край и область в GeographicalNamesInflection
Russian:
город, край и область в GeographicalNamesInflectionо/об из всех функций склонения. Теперь чтобы его добавить оберните склонённое слово в вызов RussianLanguage::about():RussianLanguage::about(NounDeclension::getCase('обед', 'предложный')) => 'об обеде'
Добавлены методы, добавляющие к слову верную форму предлога в (во), об (о, обо), c (со):
Russian:
в (во), об (о, обо), c (со):
RussianLanguage::about($word) - добавляет о/об/обо в зависимости от букв, с которых начинается словоRussianLanguage::in($word) - добавляет в/во в зависимости от букв, с которых начинается словоRussianLanguage::with($word) - добавляет с/со в зависимости от букв, с которых начинается словосервер, халат.Added TimeSpeller class: morphos\English\TimeSpeller::spellInterval(DateInterval $interval)
English:
morphos\English\TimeSpeller::spellInterval(DateInterval $interval)morphos\English\pluralize() function:
pluralize($count, $word)"%n %word"Исправлено склонение составных фамилий: Мартен-Люган, Копусов-Долинин
Russian:
Мартен-Люган, Копусов-Долининый, ные, ны: Набережные Челны, Грозныйmorphos\Russian\pluralize(): изменён порядок аргументов: pluralize($count, $word)Исправлено склонение мужских фамилий на ой, ых, ко: Толстой, Фоминых, Стецко
Russian:
ой, ых, ко: Толстой, Фоминых, Стецкоая: СтальнаядвеХристиан, АлександрGeneralDeclension → NounDeclension
Russian
renamed classes:
GeneralDeclension → NounDeclensionPlurality → NounPluralizationTimeUnitSpeller → TimeSpellerpartially renamed classes:
CardinalNumeral → CardinalNumeralGeneratorOrdinalNumeral → OrdinalNumeralGeneratorFirstNamesDeclension, MiddleNamesDeclension, LastNamesDeclension, GeographicalNamesDeclension: Declension replaced with Inflectionfunctions change:
name() renamed to inflectName()pluralize() now returns a string in format "%n %word" instead of inflected word only.English:
CardinalNumeral → CardinalNumeralGeneratorOrdinalNumeral → OrdinalNumeralGeneratorPlurality → NounPluralizationRussian:
NounDeclension::detectGender() for gender detection of nouns.ха.Now Morphos fully meets PSR-2.
Renamed MoneyFormatter to MoneySpeller
MoneyFormatter to MoneySpellerRussian:
TimeUnitSpeller: Spells date&time intervals like 5 часов и 6 минут назадname() functionAdded case for 0 in CardinalNumeral
Russian:
MoneyFormatter0 in CardinalNumeralовFixed bug in cardinal numerals generating classes (morphos\Russian\CardinalNumeral, morphos\English\CardinalNumeral) leading to infinite loop on x86.
morphos\Russian\CardinalNumeral, morphos\English\CardinalNumeral) leading to infinite loop on x86.English:
Added script to test morphos functionality (bin/morphos).
bin/morphos).Russian:
ая: Закипнаяь or with a consonant.ль: Ставрополь, Ярославльрь: Тверьки: Березники, Ессентукимь: Пермь, Кемьнь: Рязань, НазраньAdded declension and pluralization of Russian Augmentatives: волчище, полотнище
Updates in general declension:
волчище, полотнищесуществительное, выходной, запятая, рабочийписьмо -> писем, ядро -> ядерпень -> пня, котенок -> котенка-ие: сообщение, воскрешениеFixed morphos\Russian\Plurality::pluralize($word, $count) for $count > 100. (_thanks to @alexlcdee_)
morphos\Russian\Plurality::pluralize($word, $count) for $count > 100. (thanks to @alexlcdee)Rules for words with run-away vowels
Updated rules of geographical names declension: added support for two-words names like Нижний Новгород.
Нижний Новгород.Updates rules for general nouns declension.
web/index.php for testing (now with Material Design)All methods of all classes are static now. Not need to create instanes of declension classes anymore. `php echo morphos\Russian\GeneralDeclension::get
echo morphos\Russian\GeneralDeclension::getCases('стол');
morphos\NamesDeclension gender constants (MAN and WOMAN) replaced by morphos\Gender constants MALE, FEMALE and NEUTERUpdated gender-detection rules.
Updated gender-detection rules.
Nothing published for this version
Deleted all global functions! Now global namespace is not used at all.
morphos\Russian\pluralize($word, $count = 2, $animateness = false)morphos\English\pluralize($word, $count = 2)morphos\Russian\nameCase() is renamed to morphos\Russian\name()morphos\S for internal use.Fixed bug in Ordinal numeral generator when numbers like 13 or 1013 formatted as two summands.
13 or 1013 formatted as two summands.Fixed handling of PREPOSITIONAL case in nameCase() function.
Fixed collision leading to error when using morphos\Russian\CasesHelper.
Added support for generation Russian ordinal numerals (525 => пятьсот двадцать пятый)
525 => пятьсот двадцать пятый)119 => one hundred nineteen)Add gender auto-detection in declension classes
Now you can use following values as $case in getForm() methods and in nameCase() function:
getForm() -> getCase()getForms() -> getCases()hasForms() -> isMutable()$case in getForm() methods and in nameCase() function:
nominative, nominativus, n, именительный, именит instead of Cases::NOMINATIVEgenetive, g, родительный, родит instead of Cases::GENITIVEdative, dativus, d, дательный, дат instead of Cases::DATIVEaccusative, винительный, винит instead of Cases::ACCUSATIVEablative, ablativus, творительный, творит instead of Cases::ABLATIVEprepositional, praepositionalis, p, предложный, предлож instead of Cases::PREPOSITIONALChanged constant Cases::GENETIVE to Cases::GENITIVE. The old constant will be present in morphos for a while.
Cases::GENETIVE to Cases::GENITIVE. The old constant will be present in morphos for a while.Added handling of immutable nouns.
Nothing published for this version
Added CardinalNumeral::generate() for one-call generation.
Added gender difference in cardinal numeral generation.
Added cardinal number creation for Russian (4351 => четыре тысячи триста пятьдесят один)
4351 => четыре тысячи триста пятьдесят один)Added function to detect gender by name
Added check for masculine words with soft sign at the end
Support of Russian middle names
Changed Plurality of Russian language.
Changed Plurality of Russian language.
One column per quarter.