PHPackages                             amarruda/numeros-por-extenso - 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. amarruda/numeros-por-extenso

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

amarruda/numeros-por-extenso
============================

A package for converting numbers to their written-out form in Portuguese

v1.0.0(8mo ago)0235↓64.3%MITPHPPHP >=7.4

Since Nov 4Pushed 8mo agoCompare

[ Source](https://github.com/amarruda/numeros-por-extenso)[ Packagist](https://packagist.org/packages/amarruda/numeros-por-extenso)[ RSS](/packages/amarruda-numeros-por-extenso/feed)WikiDiscussions main Synced yesterday

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

numeros-por-extenso
===================

[](#numeros-por-extenso)

Converte números para sua representação por extenso em português (pt-BR). Permite que a saída seja flexionada com o gênero masculino (default) ou feminino.

Para que serve
--------------

[](#para-que-serve)

Este pacote fornece uma classe simples que converte números inteiros e decimais para sua forma escrita por extenso em português. É útil para gerar valores por extenso em recibos, cheques (simulação), relatórios ou qualquer contexto em que seja necessário exibir números por extenso.

Principais características:

- Suporta números inteiros e decimais (aceita vírgula ou ponto como separador decimal).
- Suporte ao gênero feminino para unidades (ex.: "uma" / "duas").
- Compatível com PHP 7.4+ (veja `composer.json`).

Instalação
----------

[](#instalação)

Instale via Composer:

```
composer require amarruda/numeros-por-extenso
```

Se estiver trabalhando dentro do repo (desenvolvimento local), apenas carregue o autoload do Composer:

```
require __DIR__ . '/vendor/autoload.php';
```

Uso
---

[](#uso)

Exemplo mínimo:

```
use Amarruda\NumerosPorExtenso\NumerosPorExtenso;

$np = new NumerosPorExtenso();

echo $np->porExtenso(1234); // "um mil, duzentos e trinta e quatro"
```

O pacote também aceita strings com separador decimal por vírgula:

```
echo $np->porExtenso('1,25'); // "um ponto dois cinco"
```

Gênero feminino:

```
echo $np->porExtenso(1, 'f'); // "uma"
```

API rápida
----------

[](#api-rápida)

- `porExtenso($numero, $genero = 'm')` — converte `$numero` para string por extenso. Retorna `string` ou `false` se a entrada não for numérica.

Aceita números do tipo `int`, `float` ou `string` numérica (ex.: "1,25" ou "1.25").

Testes
------

[](#testes)

Este projeto usa Pest para testes. Para rodar a suíte de testes localmente:

```
./vendor/bin/pest
```

Também existe um exemplo de uso em `examples/usage.php`.

Contribuição
------------

[](#contribuição)

Contribuições são bem-vindas. Sugestões:

- Adicionar mais casos de teste (números grandes, limites de PHP\_INT\_MAX, entrada inválida).
- Internacionalização (variações pt-BR / pt-PT ou outros idiomas).
- Tornar a API mais estrita retornando exceções em vez de `false` em entradas inválidas (breaking change).

Abra uma issue ou envie um PR com sua proposta.

Licença
-------

[](#licença)

MIT — veja o arquivo `LICENSE.md`.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance62

Regular maintenance activity

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

241d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/46114737581b8e0473e495b7d354552b2c5482eec547baa0d0694d23b313cfa9?d=identicon)[amarruda](/maintainers/amarruda)

---

Top Contributors

[![amarruda](https://avatars.githubusercontent.com/u/49110283?v=4)](https://github.com/amarruda "amarruda (1 commits)")

---

Tags

phppackagewordsnumbers

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/amarruda-numeros-por-extenso/health.svg)

```
[![Health](https://phpackages.com/badges/amarruda-numeros-por-extenso/health.svg)](https://phpackages.com/packages/amarruda-numeros-por-extenso)
```

###  Alternatives

[kwn/number-to-words

Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages.

4375.4M23](/packages/kwn-number-to-words)

PHPackages © 2026

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