wapmorgan/yii2-inflection

Inflection extension for Yii2. Support for English / Russian languages to inflect words / names / numbers / money / date&time.

1.0.4 2018-03-26 03:15 UTC

Requires

• wapmorgan/morphos: ~3.2.3
• yiisoft/yii2: ^2.0

Requires (Dev)

• phpunit/phpunit: ~4.8

GPL-3.0-only

• russian
• inflection
• english
• yii2

README

Inflection extension for Yii2. Support for English / Russian languages to inflect words / names / numbers / money / date&time.

1. Features
   • Cases
   • Currencies
2. How does it work
3. Installation

Features

1. Pluralize word with number:

• en: Yii::$app->inflection->pluralize(2, 'item') => 2 items
• ru: Yii::$app->inflection->pluralize(2, 'элемент') => 2 элемента

1. Inflect names to relational cases (applicable in Russian only):

• ru: Yii::$app->inflection->inflectName('Иванов Петр', wapmorgan\yii2inflection\Inflector::DATIVE) => Иванову Петру
• Description of all supported cases are in Cases section.

1. Inflect geographical names to relational cases (applicable in Russian only):

• ru: Yii::$app->inflection->inflectGeoName('Санкт-Петербург', wapmorgan\yii2inflection\Inflector::GENITIVE) => Санкт-Петербурга

1. Generate cardinal numerals:

• en: Yii::$app->inflection->cardinalize(2) => 'two'
• ru: Yii::$app->inflection->cardinalize(2) => 'два'

1. Generate ordinal numerals:

• en: Yii::$app->inflection->ordinalize(2) => '2nd'
• ru: Yii::$app->inflection->ordinalize(2) => '2-й'

And full form:

• en: Yii::$app->inflection->ordinalize(2, wapmorgan\yii2inflection\Inflector::FULL) => 'second'
• ru: Yii::$app->inflection->ordinalize(2, wapmorgan\yii2inflection\Inflector::FULL) => 'второй'

1. Money to words:

• (WIP) en: Yii::$app->inflection->monetize(wapmorgan\yii2inflection\Inflector::DOLLAR, 122.04) => 'one hundred twenty-two dollars four cents'
• ru: Yii::$app->inflection->monetize(wapmorgan\yii2inflection\Inflector::DOLLAR, 122.04) => 'сто двадцать два доллара четыре цента'
• Description of all supported currencies are in Currencies section.

1. Data range to words:

• en: Yii::$app->inflection->textizeTimeRange(new DateInterval('P2Y')) => '2 years'
• ru: Yii::$app->inflection->textizeTimeRange(new DateInterval('P2Y')) => '2 года'

WIP means Work-in-progress i.e this feature is not supported now, but planned to be implemented.

Cases

Case	Russian
Inflector::NOMINATIVE	Именительный
Inflector::ABLATIVE	Творительный
Inflector::ACCUSATIVE	Винительный
Inflector::AVERSIVE
Inflector::BENEFACTIVE
Inflector::CAUSAL
Inflector::COMITATIVE
Inflector::DATIVE	Дательный
Inflector::DISTRIBUTIVE
Inflector::GENITIVE	Родительный
Inflector::ORNATIVE
Inflector::POSSESSED
Inflector::POSSESSIVE
Inflector::PREPOSITIONAL	Предложный
Inflector::PRIVATIVE
Inflector::SEMBLATIVE
Inflector::SOCIATIVE

Currencies

Currency
Inflector::DOLLAR
Inflector::EURO
Inflector::YEN
Inflector::POUND
Inflector::FRANC
Inflector::YUAN
Inflector::KRONA
Inflector::PESO
Inflector::WON
Inflector::LIRA
Inflector::RUBLE
Inflector::RUPEE
Inflector::REAL
Inflector::RAND
Inflector::HRYVNIA

How does it work

It uses built-in inflector for English pluralization (yii\helpers\Inflector) and Morphos for English & Russian on-the-fly inflection (without dictionaries).

Installation

1. Install extension

composer require wapmorgan/yii2-inflection

1. Add wapmorgan\yii2inflection\Inflection as a service inflection in config and specify proper target language of your application (web.php or console.php):

$config = [
  // ...
  'language' => 'ru_RU', // for example, Russian
  // ...
  'components' => [
    // ...
    'inflection' => [
      'class' => 'wapmorgan\yii2inflection\Inflection'
    ]
  ],
  // ...
];

• Optional service parameters:
  • language - default language for inflection. By default, it uses language parameter of current application, but you can change this behavior. Currently supported langs is ru (Russian) and en (English) or their's modification (ru_RU, en_US). If you pass unsupported or unknown language, an Exception will be thrown during service initializion.
  • defaultCurrency - default currency when converting money to words. If set, you can call monetize(float $value) without currency: Yii::$app->inflection->monetize(123.45) => сто двадцать три рубля сорок пять копеек

1. Call any methods described above in a controller / command / view.

$word = 'новость';
echo Yii::$app->inflection->pluralize(rand(2, 139), $word).PHP_EOL;
echo Yii::$app->inflection->pluralize(rand(9, 69), $word).PHP_EOL;