extenso

Conversão de valores por extenso em PHP, _(*2)

Suporta números até a casa dos vigesilhões.
Suporta casas decimais até vigesilhões.
Verificado com testes automatizados.
Usa Versionamento Semâtico.

Instalação

Versão para PHP 8.x:, _(*3)

composer require phputil/extenso

Versão para PHP 5.4 até 7.x:, _(*4)

composer require phputil/extenso@2

Documentação

Estilos aceitos:, _(*5)

Estilo	Exemplo	Saída
MOEDA	1001	mil e um reais
NUMERO_MASCULINO	1001	mil e um
NUMERO_FEMININO	1001	mil e uma

Exemplos

Uso com classe Extenso:, _(*6)

require_once 'vendor/autoload.php';

use phputil\extenso\Extenso;

$e = new Extenso();
$e->extenso( 1001 ); // mil e um reais

$e->extenso( 1001, Extenso::MOEDA ); // mil e um reais
$e->extenso( 1001, Extenso::NUMERO_MASCULINO ); // mil e um
$e->extenso( 1001, Extenso::NUMERO_FEMININO ); // mil e uma

$e->extenso( 1001.01 ); // mil e um reais e um centavo
$e->extenso( 1001.001 ); // mil e um reais e um milésimo

// quatro milhões vinte e cinco mil oitocentos reais e noventa e nove centavos
$e->extenso( 4025800.99 );

Uso com funções - versão 2.1 ou posterior:, _(*7)

require_once 'vendor/autoload.php';

use phputil\extenso\extenso;
use phputil\extenso\moeda;
use phputil\extenso\masculino;
use phputil\extenso\feminino;

extenso( 1001 );   // mil e um reais
moeda( 1001 );     // mil e um reais
masculino( 1001 ); // mil e um
feminino( 1001 );  // mil e uma