rmunate / spell-number
Spell out numbers, money amounts, and ordinals in Laravel using PHP Intl.
Requires
- php: ^8.0
- ext-intl: *
- illuminate/support: ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0
Requires (Dev)
- laravel/framework: ^12.0 || ^13.0
- phpunit/phpunit: ^11.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
SpellNumber 5.0.0 uses PHP Intl to spell out numbers, money amounts, and ordinals. It includes formatting defaults for 11 languages, configurable currency labels and output replacements, and Laravel macros.
Installation
- Laravel 8–13 and a PHP version supported by your Laravel release.
- PHP 8.0 or later with
intlandmbstringenabled. Laravel 13 requires PHP 8.3 or later.
composer require rmunate/spell-number:^5.0
Laravel discovers the service provider automatically. Publishing the configuration is optional.
Usage
use Rmunate\Utilities\SpellNumber; SpellNumber::value(100)->locale('en')->toLetters(); // one hundred SpellNumber::float('1.01')->locale('es')->currency('pesos')->fraction('centavos')->toMoney(); // un peso con un centavo SpellNumber::integer(2)->locale('es')->toOrdinal(SpellNumber::ORDINAL_FEMALE); // segunda
For exact decimals, pass a string with a dot and no grouping separators. Output is lowercase by default; ICU versions can differ in their spellings and available ordinal rules.
Documentation · Laravel quickstart · API reference · Upgrade to 5.0.0
Contributing
Run composer test for the PHP suite. See the contribution guide for docs builds, CI, and release steps.
Thanks to Ashok Devatwal, Olsza, Siros Fakhri, Jens Twesmann, Gabriel Rausch, Alejandro Diaz, Frank Sepulveda, Ngô Quốc Đạt, and everyone who has contributed.
Released under the MIT License.