Search by

rmunate / spell-number

rmunate

Spell out numbers, money amounts, and ordinals in Laravel using PHP Intl.

Package info

github.com/rmunate/SpellNumber

pkg:composer/rmunate/spell-number

Statistics

Installs: 285 011

Dependents: 0

Suggesters: 0

Stars: 298

Open Issues: 0

v5.0.0 2026-11-18 20:21 UTC

README

CI and GitHub Pages Packagist

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 intl and mbstring enabled. 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.