prgrant / Morphos

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 intervals.

Morphos

A morphological solution for Russian and English language written completely in PHP.

Tests & Quality:

Features

• [✓] Inflection of Personal names (Фамилия, Имя, Отчество) (Russian)
• [✓] Inflection of Geographical names (Страны/Города) (Russian)
• [✓] Declension/Pluralization of nouns and adjectives (Russian, English)
• [✓] Generation numerals of numbers (количественные и порядковые) (Russian, English)
• [✓] Spelling out amounts of money (Russian)
• [✓] Spelling out time units and intervals (Russian, English)

Table of contents

1. Installation
2. Quick start
3. Documentation
4. Contributing

Installation

• Download library through composer:

composer require wapmorgan/morphos

Adapters

• Adapter for Blade: wapmorgan/morphos-blade
• Adapter for Twig: wapmorgan/morphos-twig
• Adapter for Yii2: wapmorgan/yii2-inflection

Quick Start

Russian

// Inflect russian names:
morphos\Russian\inflectName('Иванов Петр', 'родительный') => 'Иванова Петра'

// Inflect geographical names:
morphos\Russian\GeographicalNamesInflection::getCase('Москва', 'родительный') => 'Москвы'

// Pluralize russian nouns:
morphos\Russian\pluralize(10, 'дом') => '10 домов'

// Generate russian cardinal numerals:
morphos\Russian\CardinalNumeralGenerator::getCase(567, 'именительный') => 'пятьсот шестьдесят семь'

// Generate russian ordinal numerals:
morphos\Russian\OrdinalNumeralGenerator::getCase(961, 'именительный') => 'девятьсот шестьдесят первый'

// other functions described in README-ru.md

English

// Pluralize english nouns:
morphos\English\pluralize(10, 'house') => '10 houses'

// Generate english cardinal numerals:
morphos\English\CardinalNumeralGenerator::generate(567) => 'five hundred sixty-seven'

// Generate english ordinal numerals:
morphos\English\OrdinalNumeralGenerator::generate(961) => 'nine hundred sixty-first'

Documentation

• Русская морфология в файле README-ru.md
• English morphology in file README-en.md

Contributing

See CONTRIBUTING.md for this.