Fatal error: Uncaught JsonException: Syntax error in index.php:4
Textul dat lui json_decode (cu JSON_THROW_ON_ERROR) nu e JSON valid: ghilimele simple, chei fără ghilimele, virgulă după ultimul element sau text gol. Corectează JSON-ul sau prinde JsonException și tratează datele invalide.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu opțiunea JSON_THROW_ON_ERROR (PHP 7.3+), json_decode() și json_encode() aruncă JsonException în loc să întoarcă null sau false în tăcere. Syntax error este mesajul pentru un text care nu respectă formatul JSON.
Greșelile tipice în JSON:
- ghilimele simple:
{'nume': 'Ana'}(JSON acceptă doar ghilimele duble); - chei fără ghilimele:
{nume: "Ana"}; - virgulă după ultimul element:
{"a": 1,}sau[1, 2,]; - textul gol
''sau un răspuns HTML (o pagină de eroare) în loc de JSON; - comentarii, valori
undefinedsauNaN, care există în JavaScript, dar nu în JSON.
Fără JSON_THROW_ON_ERROR, aceleași texte fac json_decode să întoarcă null, iar eroarea se vede doar cu json_last_error_msg(). Alte mesaje posibile: Malformed UTF-8 characters, Maximum stack depth exceeded.
De ce apare: cauzele frecvente
1Ghilimele simple sau chei fără ghilimele
<?php
$json = "{'nume': 'Ana'}";
$d = json_decode($json, true, 512, JSON_THROW_ON_ERROR);<?php
$json = '{"nume": "Ana"}';
$d = json_decode($json, true, 512, JSON_THROW_ON_ERROR);În JSON cheile și textele se scriu doar între ghilimele duble.
2Virgulă după ultimul element
<?php
$json = '{"id": 7, "total": 99.5,}';
$d = json_decode($json, true, 512, JSON_THROW_ON_ERROR);<?php
$json = '{"id": 7, "total": 99.5}';
$d = json_decode($json, true, 512, JSON_THROW_ON_ERROR);Spre deosebire de PHP și JavaScript, JSON nu permite virgula de la final.
3Date din afară netratate
<?php
$raspuns = '<html>Eroare 500</html>';
$d = json_decode($raspuns, true, 512, JSON_THROW_ON_ERROR);<?php
$raspuns = '<html>Eroare 500</html>';
try {
$d = json_decode($raspuns, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
$d = null;
echo 'Răspuns invalid: ' . $e->getMessage();
}Datele venite de la un API sau de la utilizator pot fi oricând invalide; tratează cazul cu try/catch.
Repară eroarea, direct în pagină
Configurația aplicației e scrisă ca JSON direct în cod, dar are greșeli de format și json_decode aruncă JsonException: Syntax error. Corectează textul JSON (păstrând aceleași chei și valori), ca programul să afișeze Aplicație: Magazin, Monedă: RON și TVA: 21%.
<?php
$json = "{'aplicatie': 'Magazin', 'moneda': 'RON', 'tva': 21,}";
$config = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
echo "Aplicație: {$config['aplicatie']}\n";
echo "Monedă: {$config['moneda']}\n";
echo "TVA: {$config['tva']}%\n";Aplicație: Magazin Monedă: RON TVA: 21%
Indiciu
JSON cere ghilimele duble la chei și la texte și nu acceptă virgulă după ultimul element.
Reparația
<?php
$json = '{"aplicatie": "Magazin", "moneda": "RON", "tva": 21}';
$config = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
echo "Aplicație: {$config['aplicatie']}\n";
echo "Monedă: {$config['moneda']}\n";
echo "TVA: {$config['tva']}%\n";De ce merge
JSON-ul inițial avea două probleme: ghilimele simple în jurul cheilor și textelor și o virgulă după ultimul element. Ambele sunt permise în PHP și JavaScript, dar nu în JSON, așa că json_decode cu JSON_THROW_ON_ERROR a aruncat JsonException: Syntax error.
În varianta corectă, textul PHP e între ghilimele simple, iar înăuntru JSON-ul folosește ghilimele duble, fără virgula finală. Și mai sigur: ai fi putut scrie configurația direct ca tablou PHP sau s-o generezi cu json_encode(), ca să nu mai scrii JSON de mână.
Alte forme ale mesajului
PHP Fatal error: Uncaught JsonException: Syntax error in /var/www/html/api.php:12Fatal error: Uncaught JsonException: Malformed UTF-8 characters, possibly incorrectly encoded in index.php:4Fatal error: Uncaught JsonException: Control character error, possibly incorrectly encoded in index.php:4Fatal error: Uncaught JsonException: Maximum stack depth exceeded in index.php:4
Cum o eviți pe viitor
- Nu scrie JSON de mână în cod; construiește un tablou PHP și transformă-l cu
json_encode(). - Folosește întotdeauna
JSON_THROW_ON_ERRORși prindeJsonExceptionacolo unde datele vin din afară. - Validează JSON-ul suspect într-un validator online sau cu
json_validate()(PHP 8.3+). - Când un API întoarce eroare, verifică întâi codul HTTP și abia apoi decodează corpul răspunsului.
Întrebări frecvente
De ce json_decode îmi întoarce null fără nicio eroare?
Pentru că fără JSON_THROW_ON_ERROR funcția nu aruncă excepții. Verifică json_last_error_msg() imediat după apel sau, mai bine, adaugă opțiunea, ca greșelile să nu treacă neobservate.
Ce înseamnă 512 din apel?
Este adâncimea maximă de imbricare (depth), valoarea implicită. Trebuie scrisă doar pentru că opțiunile sunt al patrulea parametru. Cu argumente numite poți scrie json_decode($json, true, flags: JSON_THROW_ON_ERROR).
Erori înrudite
Fatal error: Uncaught Error: Cannot use object of type stdClass as array in index.php:4 Ai un obiect (de obicei rezultatul lui json_decode fără al doilea parametru) și îl citești cu paranteze pătrate, ca pe un tablou. Fie decodezi cu json_decode($json, true), fie citești câmpurile cu ->: $obj->nume. Warning: Trying to access array offset on null in index.php on line 4 Folosești $x['cheie'] pe o variabilă care este null, nu un tablou. De obicei o funcție de căutare n-a găsit nimic sau o cheie de pe nivelul de mai sus lipsește. Verifică întâi rezultatul (cu ?? sau if) înainte să-l indexezi. Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in index.php:6 Codul aruncă o excepție (cu throw) pe care nu o prinde nimeni, așa că scriptul se oprește. Pune apelul care poate eșua într-un try și tratează excepția în catch (de exemplu afișezi mesajul și continui). Î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.
