...
Eroare PHP · Excepții, JSON și expresii regulate

Fatal error: Uncaught JsonException: Syntax error in index.php:4

Pe scurt

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 undefined sau NaN, 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

Greșit
PHP
<?php
$json = "{'nume': 'Ana'}";
$d = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
Corect
PHP
<?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

Greșit
PHP
<?php
$json = '{"id": 7, "total": 99.5,}';
$d = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
Corect
PHP
<?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

Greșit
PHP
<?php
$raspuns = '<html>Eroare 500</html>';
$d = json_decode($raspuns, true, 512, JSON_THROW_ON_ERROR);
Corect
PHP
<?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ă tu

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

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Aplicație: Magazin
Monedă: RON
TVA: 21%
Indiciu

JSON cere ghilimele duble la chei și la texte și nu acceptă virgulă după ultimul element.

Alte forme ale mesajului

  • PHP Fatal error: Uncaught JsonException: Syntax error in /var/www/html/api.php:12
  • Fatal error: Uncaught JsonException: Malformed UTF-8 characters, possibly incorrectly encoded in index.php:4
  • Fatal error: Uncaught JsonException: Control character error, possibly incorrectly encoded in index.php:4
  • Fatal 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 prinde JsonException acolo 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

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