Weave Code
Ru Strings Bundle Laravel Package
it-blaster/ru-strings-bundle
it-blaster/ru-strings-bundle is a Laravel/PHP package that bundles Russian string helpers and localization utilities, making it easier to handle Russian text, pluralization, and language-specific formatting in your applications.
Склонение по падежам и сопряжение с числом в twig + сервис для Symfony2
Frequently asked questions about Ru Strings Bundle
- Can I install it-blaster/ru-strings-bundle in a Laravel application with Composer?
- You can run composer require, but nothing will wire up. The package is a Symfony2 bundle: it ships a kernel-registered Bundle class, a Symfony DI service definition, and a Twig extension, none of which Laravel reads. Installing it verbatim would pull Twig and Symfony dependency-injection into your app for one line of Russian text. The realistic approach is to treat it as MIT-licensed reference source and copy the string logic rather than depend on it.
- What does RU Strings Bundle actually do for Russian text?
- It provides framework-agnostic helpers for Russian pluralization (1 файл, 2 файла, 5 файлов), Cyrillic-to-Latin and Latin-to-Cyrillic transliteration, and some locale-aware formatting. Around that logic it wraps a Symfony bundle, service definitions, and Twig filters for declension and pluralization. The durable asset is the string logic; everything else is Symfony-specific plumbing.
- Does the Twig extension work with Laravel Blade?
- No. The Twig extension exposes filters that only exist inside Twig's environment, and Blade has no equivalent registration path for them. To use the underlying logic in Blade you would register a Laravel service provider and expose a helper plus a Blade directive, for example ru_plural($count, $forms) or @ru_decline. That is a fork-and-own task, not a configuration change.
- How do I handle Russian pluralization in Laravel without this package?
- Use trans_choice with Laravel's range selectors, for example {0} файлов|{1} файл|[2,4] файла|[5,*] файлов. This covers the majority of numeric concord cases with zero dependencies and no maintenance burden. Only genuine grammatical case declension of proper nouns still needs external logic, which is the part worth extracting from this bundle.
- How do I extract the declension logic from this bundle into a Laravel service provider?
- Copy the declension and concord classes into app/Support/RussianStrings/ or a private Composer package, then strip every Symfony and Twig reference. Register a RussianStringsServiceProvider, bind the class in the container, and expose a helper and Blade directive. A mid-level Laravel developer can complete this in one to two days, but budget extra time for source-audit surprises such as PHP 5-era constructs that break under PHP 8.
- Does the package handle the 11-14 exception, zero, and fractional counts correctly?
- There is no test suite in the repository, so this cannot be verified from the outside. Russian has well-known traps at 11 through 14, on zero, on fractions, and on gendered and animate nouns, and the package documentation does not state how these are resolved. Before relying on it, read the source and write your own tests for those cases, or run the outputs past a native speaker.
- Is there a test suite validating the Russian grammar tables?
- No visible test suite exists, and the repo has zero stars, zero dependents, and no issue activity, so there is no external validation of the grammar rules either. That matters most if declension is implemented as a lookup dictionary rather than suffix rules, because a dictionary silently caps your coverage. Treat correctness as an open question and budget for a linguistic review before shipping.
- What PHP version does it require, and will it run on PHP 8.2?
- The bundle targets Symfony2, which reached end of life in 2015, so the code is likely PHP 5.3 to 5.6 era. Expect constructs removed in PHP 7 and 8 such as each(), create_function(), and PSR-0 autoloading that may not resolve under Composer 2. Read the composer.json constraint and run a source audit before assuming any modern compatibility.
- Is the package actively maintained and safe to use in production?
- There is no visible maintenance: no issue triage, no CVE feed, and no community around the project, and no upstream would merge your patches if you forked it. The MIT license keeps legal friction near zero, but the technical risk is high and concentrated in maintenance and linguistic correctness. If you use it, plan to own the code outright rather than track upstream releases.
- What are the alternatives for Russian pluralization and transliteration in Laravel?
- For pluralization, Laravel's built-in trans_choice with range selectors is the standard replacement and removes the dependency for most use cases. For transliteration, PHP's intl extension and iconv cover most Cyrillic-to-Latin needs without a package. For true grammatical declension of names and proper nouns, extract the logic from this bundle into a private package and add tests, since no maintained Laravel-native equivalent is available here.
Weaver
How can I help you explore Laravel packages today?