PHPackages                             joelhmetz/laravel-number-to-words - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. joelhmetz/laravel-number-to-words

ActiveLibrary[Utility & Helpers](/categories/utility)

joelhmetz/laravel-number-to-words
=================================

Laravel package to convert numbers and currency values to words in Portuguese (Brazil)

v1.0.2(6mo ago)18MITPHPPHP ^8.1|^8.2|^8.3|^8.4

Since Oct 31Pushed 6mo agoCompare

[ Source](https://github.com/joelhmetz/laravel-number-to-words)[ Packagist](https://packagist.org/packages/joelhmetz/laravel-number-to-words)[ RSS](/packages/joelhmetz-laravel-number-to-words/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (4)Used By (0)

Laravel Number To Words
=======================

[](#laravel-number-to-words)

Convert numbers and currency values to words in Portuguese (Brazil) for Laravel applications.

Features
--------

[](#features)

- ✅ Convert numbers to words
- ✅ Convert currency values to words (BRL)
- ✅ Bug-free (no trailing "e" issue)
- ✅ Easy to use with Facade and helpers
- ✅ Laravel 9, 10, and 11 support
- ✅ PHP 8.0+ support

Installation
------------

[](#installation)

```
composer require joelhmetz/laravel-number-to-words
```

### Publish Configuration (Optional)

[](#publish-configuration-optional)

```
php artisan vendor:publish --tag=number-to-words-config
```

Usage
-----

[](#usage)

### Using Facade

[](#using-facade)

```
use Joelhmetz\LaravelNumberToWords\Facades\NumberToWords;

// Convert number to words
NumberToWords::spell(123);
// "cento e vinte e três"

NumberToWords::spell(1000);
// "mil"

// Convert currency to words
NumberToWords::currency(1234.56);
// "mil duzentos e trinta e quatro reais e cinquenta e seis centavos"

NumberToWords::currency(100);
// "cem reais"
```

### Using Helpers

[](#using-helpers)

```
// Convert number to words
number_to_words(456);
// "quatrocentos e cinquenta e seis"

// Convert currency to words
currency_to_words(789.99);
// "setecentos e oitenta e nove reais e noventa e nove centavos"
```

### Direct Instantiation

[](#direct-instantiation)

```
$converter = new \Joelhmetz\LaravelNumberToWords\NumberToWords();

$converter->spell(500);
// "quinhentos"

$converter->currency(1500.50);
// "mil e quinhentos reais e cinquenta centavos"
```

Examples
--------

[](#examples)

```
NumberToWords::spell(0);        // "zero"
NumberToWords::spell(1);        // "um"
NumberToWords::spell(15);       // "quinze"
NumberToWords::spell(100);      // "cem"
NumberToWords::spell(1000);     // "mil"
NumberToWords::spell(1000000);  // "um milhão"

NumberToWords::currency(0);     // "zero real"
NumberToWords::currency(1);     // "um real"
NumberToWords::currency(1.01);  // "um real e um centavo"
NumberToWords::currency(10.50); // "dez reais e cinquenta centavos"
```

Configuration
-------------

[](#configuration)

You can customize the locale in the config file `config/number-to-words.php`:

```
return [
    'locale' => env('NUMBER_TO_WORDS_LOCALE', 'pt_BR'),
];
```

Or set in your `.env` file:

```
NUMBER_TO_WORDS_LOCALE=pt_BR
```

Bug Fix
-------

[](#bug-fix)

This package includes a fix for the common "trailing e" bug found in other similar packages. Numbers are always returned without trailing "e" words.

Requirements
------------

[](#requirements)

- PHP 8.1 or higher
- Laravel 9.0, 10.0, 11.0, or 12.0

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

Author
------

[](#author)

Joel Metz -

Contributing
------------

[](#contributing)

Pull requests are welcome! Please feel free to submit issues and enhancement requests.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance67

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

193d ago

PHP version history (2 changes)v1.0.0PHP ^8.0|^8.1|^8.2|^8.3

v1.0.1PHP ^8.1|^8.2|^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/1dc88e4f02e23707ffb685443b73de64d90a7dcd7335cc578a0e2d4d769b20ae?d=identicon)[metzjuarez](/maintainers/metzjuarez)

---

Top Contributors

[![joelhmetz](https://avatars.githubusercontent.com/u/8234440?v=4)](https://github.com/joelhmetz "joelhmetz (5 commits)")

---

Tags

laravelnumber to wordsspell-numberextensobrasilportuguese

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/joelhmetz-laravel-number-to-words/health.svg)

```
[![Health](https://phpackages.com/badges/joelhmetz-laravel-number-to-words/health.svg)](https://phpackages.com/packages/joelhmetz-laravel-number-to-words)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[nedwors/navigator

A Laravel package to ease defining navigation menus

433.1k](/packages/nedwors-navigator)[xefi/faker-php-laravel

Faker php integration with laravel

1915.1k](/packages/xefi-faker-php-laravel)[dcblogdev/laravel-junie

Install pre-configured guides for Jetbrains Junie

392.5k](/packages/dcblogdev-laravel-junie)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)