Fatal error: Uncaught TypeError: number_format(): Argument #1 ($num) must be of type int|float, string given in index.php:3
Ai dat lui number_format() un text care nu e un număr valid pentru PHP, de obicei un preț scris în format românesc ("1.234,50"), cu spații sau cu monedă ("49 lei"). Transformă întâi textul în număr (scoate punctele de mii, înlocuiește virgula cu punct), apoi formatează-l.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
number_format() primește un număr și îl afișează frumos (cu zecimale și separatori). Dacă îi dai un text, PHP încearcă să-l convertească automat; merge doar dacă textul e un număr în formatul PHP: cifre, cel mult un punct zecimal, eventual semn și exponent ("1234.5"). Un text ca "1.234,50", "49,90", "12 lei" sau "" nu e număr, deci primești TypeError pentru primul argument ($num).
Situația tipică: prețul vine dintr-un formular, dintr-un CSV exportat din Excel în format românesc sau dintr-un API care trimite texte. În PHP 7 primeai doar un warning și number_format întorcea null; din PHP 8 e eroare fatală.
În PHP 8.0–8.2 mesajul spune must be of type float; din PHP 8.3 spune int|float. Cauza e aceeași. Aceeași eroare apare și la round(), abs(), floor() cu texte nenumerice.
De ce apare: cauzele frecvente
1Preț în format românesc
<?php
$pret = '1.234,50';
echo number_format($pret, 2, ',', '.');<?php
$pret = '1.234,50';
$numar = (float) str_replace(['.', ','], ['', '.'], $pret);
echo number_format($numar, 2, ',', '.');Scoți întâi punctele de mii și înlocuiești virgula cu punct, ca textul să devină 1234.50, apoi îl transformi în float.
2Text cu monedă
<?php
$pret = '49 lei';
echo number_format($pret, 2);<?php
$pret = '49 lei';
echo number_format((float) $pret, 2);(float) ia numărul de la începutul textului și ignoră restul. E bine doar când știi sigur formatul; altfel validează cu is_numeric().
3Câmp gol din formular
<?php
$reducere = $_POST['reducere'] ?? '';
echo number_format($reducere, 2);<?php
$reducere = $_POST['reducere'] ?? '';
$reducere = is_numeric($reducere) ? (float) $reducere : 0.0;
echo number_format($reducere, 2);Textul gol nu e număr. is_numeric() verifică înainte și alegi tu valoarea implicită.
Repară eroarea, direct în pagină
Funcția afiseazaPret primește prețuri scrise în format românesc, din CSV, dar se oprește cu Uncaught TypeError: number_format(): Argument #1 ($num) must be of type int|float, string given. Transformă textul în număr înainte de formatare, ca programul să afișeze 1.234,50 lei și 49,90 lei.
<?php
function afiseazaPret(string $text): string
{
return number_format($text, 2, ',', '.') . ' lei';
}
echo afiseazaPret('1.234,50') . "\n";
echo afiseazaPret('49,90') . "\n";1.234,50 lei 49,90 lei
Indiciu
Scoate punctele de mii și înlocuiește virgula cu punct: str_replace(['.', ','], ['', '.'], $text).
Reparația
<?php
function afiseazaPret(string $text): string
{
$numar = (float) str_replace(['.', ','], ['', '.'], $text);
return number_format($numar, 2, ',', '.') . ' lei';
}
echo afiseazaPret('1.234,50') . "\n";
echo afiseazaPret('49,90') . "\n";De ce merge
'1.234,50' nu e un număr pentru PHP, care folosește punctul pentru zecimale și nu cunoaște separatorul de mii. PHP 8 nu a putut converti textul și a aruncat TypeError.
str_replace(['.', ','], ['', '.'], ...) face întâi textul 1234.50, pe care (float) îl transformă corect în număr. Abia apoi number_format îl afișează în format românesc, cu virgulă la zecimale și punct la mii.
Alte forme ale mesajului
Fatal error: Uncaught TypeError: number_format(): Argument #1 ($num) must be of type float, string given in index.php:3Fatal error: Uncaught TypeError: round(): Argument #1 ($num) must be of type int|float, string given in index.php:3Warning: number_format() expects parameter 1 to be float, string given in index.php on line 3
Cum o eviți pe viitor
- Transformă datele numerice imediat ce le citești (din formular, CSV, API) și lucrează mai departe doar cu
int/float. - Scrie o funcție
pretDinText(string $s): floatpentru formatul românesc și folosește-o peste tot. - Formatează doar la afișare: în calcule și în baza de date păstrează numărul simplu.
- Pentru bani, ia în calcul să lucrezi în bani întregi (
4990în loc de49.90), ca să eviți erorile de rotunjire.
Întrebări frecvente
De ce "49.90" merge, dar "49,90" nu?
PHP folosește mereu punctul ca separator zecimal, indiferent de limba sistemului. "49.90" e un text numeric valid; "49,90" nu e.
Pot folosi NumberFormatter?
Da, dacă extensia intl e instalată: (new NumberFormatter('ro_RO', NumberFormatter::DECIMAL))->parse('1.234,50') întoarce 1234.5. E soluția cea mai robustă pentru formate locale.
Erori înrudite
Warning: A non-numeric value encountered in index.php on line 3 Faci un calcul cu un text care începe cu un număr, dar mai are și alte caractere, de exemplu "25 lei" sau "1,5". PHP folosește doar partea numerică de la început. Curăță valoarea și convertește-o explicit înainte de calcul. Fatal error: Uncaught TypeError: Unsupported operand types: string + int in index.php:4 Faci o operație matematică pe un text care nu e număr, cel mai des pentru că ai lipit texte cu + în loc de punct. În PHP textele se concatenează cu ., iar + e doar pentru numere. Fatal error: Uncaught TypeError: calculeazaRata(): Argument #1 ($luni) must be of type int, string given, called in index.php on line 8 and defined in index.php:2 Funcția cere un int, dar primește un text care nu e număr (de exemplu "12 luni" sau ""). Convertește și validează valoarea înainte de apel, de exemplu cu (int) sau filter_var, sau corectează datele trimise. Învață PHP de la zero, cu exerciții la fiecare lecție
Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
