Download the PHP package alexivanou/russian-text-bundle without Composer

RussianTextBundle

Symfony bundle providing Russian text functions: pluralization, number spelling, name inflection, noun/adjective declension, geographical name inflection, money spelling, time ago, transliteration, phone formatting, identifier validation, semantic name parsing, date formatting, and text utilities. Built on top of wapmorgan/morphos.

Also available in Russian.

Installation

Symfony Flex will auto-configure the bundle. If you don't use Flex, add to bundles.php:

Configuration

Every feature can be toggled on or off. When a feature is disabled, its service definition and autowiring alias are removed from the container at compile time — they are never instantiated, never loaded, and never consume memory.

All flags default to true.

Why this matters

Memory savings

Every service is a container object with its own definition, arguments, and tags. Even if a service is never invoked, its definition is loaded into memory during DI container compilation. Disabling unused services:

• Reduces compiled container size (files in var/cache/{env}/Container*.php)
• Lowers PHP memory consumption per request in production
• Removes autowiring aliases, speeding up dependency resolution

Performance

On each Symfony request the container goes through several compilation phases:

1. Resolution — resolving all service arguments. Fewer services = faster resolution.
2. Dump — writing the compiled container to disk (only on first request after cache clear).
3. Autowiring — searching for a matching service by type. Aliases for disabled services are not registered → faster autowiring.

Real-world example

If you only use Pluralizer and TimeSpeller (no validators, phones, declensions), disabling 15+ flags removes ~20 class definitions + 12 autowiring aliases from the container. Difference in a typical Symfony project:

Values are approximate and depend on PHP version and project complexity.

How it works

Flags are honest: if enable_pluralizer: false, then:

• Service alexivanou.russian_text.pluralizer is NOT registered
• Autowiring alias PluralizerInterface::class is NOT registered
• Any attempt to inject PluralizerInterface throws a clear ServiceNotFoundException, not a silent null

This lets IDEs and static analyzers (PHPStan, Psalm) correctly track dependencies.

Services

Twig Usage

Pluralization (pluralize filter)

Number spelling (cardinal, ordinal filters)

Money spelling (spell_money filter)

Name inflection (inflect_name filter, name_cases, detect_gender functions)

Noun declension (noun_case, noun_plural filters)

Adjective declension (adj_case filter)

Geographical name inflection (geo_case filter)

Time ago (time_ago, distance_of_time filters)

Transliteration (translit, slug filters)

Validation functions

Phone formatting

Name parsing

Date formatting

Text helpers

Case Names

All case-aware methods accept any of the following formats:

PHP Usage

Architecture

Services are split into separate classes (not one monolithic helper) so you can inject only what you need.

Each service implements a corresponding interface (PluralizerInterface, NumberSpellerInterface, etc.) and is registered with an autowiring alias. You can type-hint the interface in your constructors:

Validator architecture

The IdentifierValidator uses tagged services. Each validation rule (INN, KPP, SWIFT, IBAN, etc.) is a separate class implementing ValidationRuleInterface tagged with russian_text.validator. To add a custom validator:

The IdentifierValidator collects all tagged validators via a compiler pass and exposes them through the fluent API.

Twig extensions

Twig extensions are separated by domain:

• PluralExtension — pluralization (pluralize)
• NumeralExtension — numerals + money (cardinal, ordinal, spell_money)
• NameExtension — names (inflect_name, name_cases, detect_gender)
• DeclensionExtension — nouns (noun_case, noun_plural), adjectives (adj_case), geographical names (geo_case)
• TimeExtension — time (time_ago, distance_of_time)
• UtilityExtension — transliteration (translit, slug), text helper (truncate, ordinal_suffix, currency_symbol), date (russian_date, russian_date_genitive, russian_month, russian_day_of_week)
• ValidationExtension — phone format (phone_format, phone_is_valid, phone_detect_country), identifier validation (is_valid_inn, is_valid_snils, etc.), name parsing (parse_name, name_initials)

This design lets you disable unused features via bundle configuration and keeps your DI container lean.

What's covered vs wapmorgan/morphos

Requirements

• PHP 7.2+
• Symfony 4.2+
• Twig 2.0+
• ext-mbstring

Testing

License

MIT