jrmajor/pluralrules

Identify plural categories according to CLDR

v1.1.3 2024-11-22 19:30 UTC

Requires

• php: 8.2 - 8.4
• ext-intl: *

Requires (Dev)

• azjezz/psl: ^3.1
• hoa/compiler: ~3.17
• jrmajor/cs: ^0.6.1
• nette/php-generator: ^4.1
• nunomaduro/collision: ^8.5
• php-standard-library/phpstan-extension: ^2.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.4
• symfony/console: ^7.0
• symfony/var-dumper: ^7.1
• vaimo/composer-patches: ^5.2

MIT

• Jeremiasz Major

• i18n
• locale
• language
• l10n
• localization
• internationalization
• plural
• cldr
• plural rules
• plural categories

README

A PHP package for identifying the plural category, according to CLDR, for a given number.

Major\PluralRules\PluralRules::select('en', 1);   // 'one'
Major\PluralRules\PluralRules::select('en', 2);   // 'other'

Major\PluralRules\PluralRules::select('pl', 1);   // 'one'
Major\PluralRules\PluralRules::select('pl', 42);  // 'few'
Major\PluralRules\PluralRules::select('pl', 45);  // 'many'
Major\PluralRules\PluralRules::select('pl', 1.5); // 'other'

You may install it via composer: composer require jrmajor/pluralrules.

Contributing

This package works by compiling CLDR plural rules to PHP closures like these. This is done by gen script (php gen rules and php gen tests). Before running it, you would need to run yarn install to download cldr-core package.

Testing

vendor/bin/phpunit           # Tests
vendor/bin/phpstan analyze   # Static analysis
vendor/bin/php-cs-fixer fix  # Formatting