PHPackages                             mendesalexandre/numero-area-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. mendesalexandre/numero-area-extenso

ActiveLibrary

mendesalexandre/numero-area-extenso
===================================

Biblioteca PHP para conversão de números e áreas para formato por extenso, especialmente para documentos imobiliários

v1.1.0(2mo ago)024↓100%MITPHPPHP >=7.4

Since Jul 4Pushed 2mo agoCompare

[ Source](https://github.com/mendesalexandre/numero-area-extenso)[ Packagist](https://packagist.org/packages/mendesalexandre/numero-area-extenso)[ RSS](/packages/mendesalexandre-numero-area-extenso/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (5)Used By (0)

Numero Area Extenso
===================

[](#numero-area-extenso)

[![Latest Version on Packagist](https://camo.githubusercontent.com/8dd63d7e02248544c43e2f7f6bf8cf3481c767ae2a40b9b342412889f74fcda9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d656e646573616c6578616e6472652f6e756d65726f2d617265612d657874656e736f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mendesalexandre/numero-area-extenso)[![Total Downloads](https://camo.githubusercontent.com/8c3ec64e28975212b9cb3a6ab951aed2e54b20b57bfd17b815fa0bd3b721e327/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d656e646573616c6578616e6472652f6e756d65726f2d617265612d657874656e736f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mendesalexandre/numero-area-extenso)

Biblioteca PHP especializada para conversão de números e áreas para formato por extenso, ideal para geração de documentos imobiliários, escrituras e registros.

Características
---------------

[](#características)

- Conversão de áreas completas (metros quadrados + centímetros quadrados)
- Conversão de números simples para extenso
- Suporte a palavra feminina/masculina
- Singular/plural automático das unidades de medida
- Formatação adequada para documentos oficiais ("um mil" em vez de "mil")
- Zero dependências externas
- PSR-4 compatível
- Testado com PHPUnit

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

[](#instalação)

```
composer require mendesalexandre/numero-area-extenso
```

Uso
---

[](#uso)

```
use NumeroAreaExtenso\NumeroAreaPorExtenso;

// Área completa (metros quadrados + centímetros quadrados)
NumeroAreaPorExtenso::converteAreaCompleta('1207,35');
// "um mil e duzentos e sete metros quadrados, três mil e quinhentos centímetros quadrados"

NumeroAreaPorExtenso::converteAreaCompleta('360,00');
// "trezentos e sessenta metros quadrados"

// Aceita formatação com ponto de milhares
NumeroAreaPorExtenso::converteAreaCompleta('1.500,75');
// "um mil e quinhentos metros quadrados, sete mil e quinhentos centímetros quadrados"

// Apenas metros quadrados
NumeroAreaPorExtenso::converteMetrosQuadrados(250);
// "duzentos e cinquenta metros quadrados"

NumeroAreaPorExtenso::converteMetrosQuadrados(1);
// "um metro quadrado"

// Apenas centímetros quadrados
NumeroAreaPorExtenso::converteCentimetrosQuadrados(1500);
// "um mil e quinhentos centímetros quadrados"

// Números simples (lotes, quadras, etc.)
NumeroAreaPorExtenso::converteNumero(15);
// "quinze"

NumeroAreaPorExtenso::converteNumero(1000);
// "um mil"

// Forma feminina
NumeroAreaPorExtenso::converteNumero(1, true);
// "uma"

NumeroAreaPorExtenso::converteNumero(301, true);
// "trezentas e uma"

// Remover formatação de números brasileiros
NumeroAreaPorExtenso::removerFormatacaoNumero('R$ 1.000,50');
// "1000.50"
```

Exemplo prático - Documento imobiliário
---------------------------------------

[](#exemplo-prático---documento-imobiliário)

```
use NumeroAreaExtenso\NumeroAreaPorExtenso;

$lote = 7;
$quadra = 12;
$area = '450,75';

$texto = sprintf(
    'LOTE %d (%s), QUADRA %d (%s), com área de %s m² (%s)',
    $lote,
    NumeroAreaPorExtenso::converteNumero($lote),
    $quadra,
    NumeroAreaPorExtenso::converteNumero($quadra),
    $area,
    NumeroAreaPorExtenso::converteAreaCompleta($area)
);

// LOTE 7 (sete), QUADRA 12 (doze), com área de 450,75 m²
// (quatrocentos e cinquenta metros quadrados, sete mil e quinhentos centímetros quadrados)
```

Veja mais exemplos em [`examples/documento-imobiliario.php`](examples/documento-imobiliario.php).

Testes
------

[](#testes)

```
composer test
```

Licença
-------

[](#licença)

MIT

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance87

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

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

Every ~82 days

Total

4

Last Release

63d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7d685e58ffc2c66fbd8710e09ba770db7670e6d897992f45e84f991a55d89300?d=identicon)[mendesalexandre](/maintainers/mendesalexandre)

---

Top Contributors

[![mendesalexandre](https://avatars.githubusercontent.com/u/15237635?v=4)](https://github.com/mendesalexandre "mendesalexandre (6 commits)")

---

Tags

phpareanumeroextensodocumentosmetros-quadradoscentimetros-quadradosimobiliario

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mendesalexandre-numero-area-extenso/health.svg)

```
[![Health](https://phpackages.com/badges/mendesalexandre-numero-area-extenso/health.svg)](https://phpackages.com/packages/mendesalexandre-numero-area-extenso)
```

###  Alternatives

[cartalyst/converter

A framework agnostic measurement conversion and formatting package featuring multiple types of measurements and currency conversion.

88434.4k7](/packages/cartalyst-converter)[wgenial/numeroporextenso

Converte numeral em valor por extenso.

4666.9k](/packages/wgenial-numeroporextenso)[pestphp/pest-plugin-stressless

Stressless plugin for Pest

67792.6k16](/packages/pestphp-pest-plugin-stressless)[tomatophp/filament-locations

Database Seeds for Countries / Cities / Areas / Languages / Currancy with ready to use resources for FilamentPHP

2320.8k6](/packages/tomatophp-filament-locations)

PHPackages © 2026

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