...
Eroare PHP · Tipuri, operatori și conversii

Fatal error: Uncaught TypeError: number_format(): Argument #1 ($num) must be of type int|float, string given in index.php:3

Pe scurt

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

Greșit
PHP
<?php
$pret = '1.234,50';
echo number_format($pret, 2, ',', '.');
Corect
PHP
<?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ă

Greșit
PHP
<?php
$pret = '49 lei';
echo number_format($pret, 2);
Corect
PHP
<?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

Greșit
PHP
<?php
$reducere = $_POST['reducere'] ?? '';
echo number_format($reducere, 2);
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?php
function afiseazaPret(string $text): string
{
    return number_format($text, 2, ',', '.') . ' lei';
}

echo afiseazaPret('1.234,50') . "\n";
echo afiseazaPret('49,90') . "\n";
După reparație, programul afișează
1.234,50 lei
49,90 lei
Indiciu

Scoate punctele de mii și înlocuiește virgula cu punct: str_replace(['.', ','], ['', '.'], $text).

Alte forme ale mesajului

  • Fatal error: Uncaught TypeError: number_format(): Argument #1 ($num) must be of type float, string given in index.php:3
  • Fatal error: Uncaught TypeError: round(): Argument #1 ($num) must be of type int|float, string given in index.php:3
  • Warning: 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): float pentru 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 de 49.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

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.