PHP

NumberFormatter no PHP: R$ formatado e valor por extenso em pt-BR

O number_format($v, 2, ',', '.') resolve os separadores e para por aí: ele não sabe pôr o R$ na frente nem escrever “mil duzentos e trinta e quatro reais” no rodapé do boleto. Quem faz isso é a classe NumberFormatter, que vem com a extensão intl e já entende pt-BR sem você escrever um único array de dezenas.

Moeda e extenso em cinco linhas

$moeda = new NumberFormatter('pt_BR', NumberFormatter::CURRENCY);
echo $moeda->formatCurrency(1234.5, 'BRL');  // R$ 1.234,50

$extenso = new NumberFormatter('pt_BR', NumberFormatter::SPELLOUT);
echo $extenso->format(1234);  // mil duzentos e trinta e quatro

Para o valor cheio, separe reais e centavos antes. Jogar 1234.50 direto no SPELLOUT devolve mil duzentos e trinta e quatro vírgula cinco, que não serve para nota nem para boleto:

$valor = 1234.50;
$centavos = (int) round(fmod($valor, 1) * 100);
$texto = $extenso->format((int) $valor) . ' reais';
if ($centavos > 0) {
    $texto .= ' e ' . $extenso->format($centavos) . ' centavos';
}
echo $texto;  // mil duzentos e trinta e quatro reais e cinquenta centavos

Dois tropeços que custam tempo

O primeiro é o erro Uncaught Error: Class "NumberFormatter" not found. Falta a extensão: sudo apt install php8.3-intl e depois sudo systemctl restart php8.3-fpm. Confirme com php -m | grep intl, e lembre que o CLI e o FPM podem carregar php.ini diferentes — funcionar no terminal não quer dizer funcionar no site.

O segundo é mais silencioso: o espaço entre o R$ e o número é um espaço não separável (U+00A0), não o espaço da barra. Se você compara a string com 'R$ 1.234,50' num teste, ou tenta um str_replace('R$ ', '', $s), nunca bate. Para voltar ao float use $moeda->parseCurrency($s, $cur), que devolve o número e ainda preenche $cur com BRL, em vez de mexer no texto na unha.

Post Recentes

API do DeepSeek no PHP: a mesma chamada da OpenAI trocando URL e chave

A API do DeepSeek aceita o mesmo formato de chat da OpenAI: troque a URL base e a chave, ponha…

9 horas atrás

Migrar models do CodeIgniter 3 para o 4 sem perder campo no insert

Converta os models do CodeIgniter 3 para a classe Model do CI4 com table, allowedFields e returnType, sem perder campos…

23 horas atrás

Cores no theme.json: trocar a paleta do tema de blocos sem plugin

Coloque as cores da marca no seletor do editor de blocos pelo theme.json, use as variáveis CSS geradas e bloqueie…

2 dias atrás

static-content:deploy pt_BR: gerar o idioma certo no Magento 2

A loja voltou em inglês depois do deploy porque pub/static só tem en_US. Gere o pt_BR no tema certo e…

3 dias atrás

Cache type próprio no Magento 2: cache.xml, TagScope e cache:clean

Seu módulo guarda resposta de API e você quer uma linha só dele no Cache Management. Declare o tipo em…

3 dias atrás

json_decode retornando null: achar o erro com JSON_THROW_ON_ERROR

O json_decode devolveu null e o PHP não disse nada. Veja como usar json_last_error_msg e JSON_THROW_ON_ERROR pra descobrir o que…

4 dias atrás