Fatal error: Uncaught JsonException: Recursion detected in index.php:18
json_encode() a dat peste un obiect care se conține pe sine, direct sau indirect (copilul are referință la părinte, părintele la copil). JSON nu poate reprezenta un ciclu. Implementează JsonSerializable și întoarce doar datele necesare, fără referința înapoi.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
json_encode parcurge obiectul și toate proprietățile lui publice, apoi proprietățile acestora și așa mai departe. Dacă ajunge din nou la un obiect pe care îl encodează deja, ar intra într-o buclă fără sfârșit. PHP se oprește și raportează Recursion detected: cu JSON_THROW_ON_ERROR primești JsonException, fără el json_encode întoarce false, iar json_last_error_msg() spune Recursion detected.
Cazul tipic e un arbore: o categorie ține lista de copii, iar fiecare copil ține o referință la parinte. Sau o comandă cu produse, unde fiecare produs știe comanda din care face parte.
Linia din mesaj e apelul json_encode. Soluția e să controlezi ce ajunge în JSON: JsonSerializable cu jsonSerialize(), sau un tablou construit manual.
De ce apare: cauzele frecvente
1Referință copil → părinte
<?php
$parinte = new stdClass();
$copil = new stdClass();
$copil->parinte = $parinte;
$parinte->copii = [$copil];
echo json_encode($parinte, JSON_THROW_ON_ERROR);<?php
$parinte = new stdClass();
$parinte->nume = 'Haine';
$copil = new stdClass();
$copil->nume = 'Geci';
$parinte->copii = [$copil];
echo json_encode($parinte, JSON_THROW_ON_ERROR);Fără referința înapoi, structura e un arbore simplu și se poate encoda.
2Clasă cu legături în ambele sensuri
<?php
class Nod { public array $copii = []; public ?Nod $parinte = null; }
$a = new Nod(); $b = new Nod();
$b->parinte = $a; $a->copii[] = $b;
echo json_encode($a, JSON_THROW_ON_ERROR);<?php
class Nod implements JsonSerializable
{
public array $copii = [];
public ?Nod $parinte = null;
public function jsonSerialize(): array { return ['copii' => $this->copii]; }
}
$a = new Nod(); $b = new Nod();
$b->parinte = $a; $a->copii[] = $b;
echo json_encode($a, JSON_THROW_ON_ERROR);jsonSerialize alege ce intră în JSON și lasă afară parinte.
Repară eroarea, direct în pagină
Fiecare subcategorie ține o referință la părintele ei, iar json_encode se oprește cu JsonException: Recursion detected. Fă clasa Categorie să implementeze JsonSerializable și să întoarcă doar nume și copii, ca programul să afișeze {"nume":"Haine","copii":[{"nume":"Geci","copii":[]}]}.
<?php
class Categorie
{
public array $copii = [];
public ?Categorie $parinte = null;
public function __construct(public string $nume) {}
public function adauga(Categorie $copil): void
{
$copil->parinte = $this;
$this->copii[] = $copil;
}
}
$haine = new Categorie('Haine');
$haine->adauga(new Categorie('Geci'));
echo json_encode($haine, JSON_THROW_ON_ERROR) . "\n";{"nume":"Haine","copii":[{"nume":"Geci","copii":[]}]}Indiciu
jsonSerialize() întoarce ['nume' => ..., 'copii' => ...], fără parinte.
Reparația
<?php
class Categorie implements JsonSerializable
{
public array $copii = [];
public ?Categorie $parinte = null;
public function __construct(public string $nume) {}
public function adauga(Categorie $copil): void
{
$copil->parinte = $this;
$this->copii[] = $copil;
}
public function jsonSerialize(): array
{
return ['nume' => $this->nume, 'copii' => $this->copii];
}
}
$haine = new Categorie('Haine');
$haine->adauga(new Categorie('Geci'));
echo json_encode($haine, JSON_THROW_ON_ERROR) . "\n";De ce merge
Haine conținea Geci, iar Geci avea parinte = Haine. json_encode ar fi mers la nesfârșit Haine → Geci → Haine..., deci s-a oprit cu Recursion detected.
Cu JsonSerializable, PHP folosește tabloul întors de jsonSerialize() în loc de toate proprietățile publice. Referința parinte nu mai intră în JSON, iar copiii sunt encodați tot prin jsonSerialize, deci ciclul dispare.
Alte forme ale mesajului
PHP Fatal error: Uncaught JsonException: Recursion detected in /var/www/html/index.php:18Recursion detectedFatal error: Uncaught JsonException: Type is not supported in index.php:5
Cum o eviți pe viitor
- Pentru obiectele pe care le trimiți ca JSON (API-uri, răspunsuri AJAX), implementează
JsonSerializableși întoarce tablouri simple. - Evită să encodezi direct entități cu relații în ambele sensuri; construiește un DTO sau un tablou.
- Folosește mereu
JSON_THROW_ON_ERROR, ca să nu primești în tăcerefalse. - „Type is not supported” e ruda acestei erori: în date a rămas o resursă (un fișier deschis, o conexiune).
Întrebări frecvente
De ce fără JSON_THROW_ON_ERROR nu văd nicio eroare?
Pentru că json_encode întoarce false, iar echo false nu afișează nimic. Verifici cu json_last_error_msg() sau, mai bine, folosești flagul care aruncă excepție.
var_dump afișează *RECURSION*, e aceeași problemă?
Da, var_dump și print_r marchează astfel ciclul, dar nu se opresc. json_encode nu poate reprezenta ciclul în JSON, deci refuză.
Erori înrudite
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. Fatal error: Uncaught JsonException: Inf and NaN cannot be JSON encoded in index.php:6 Datele pe care le transformi în JSON conțin INF (infinit) sau NAN (nu e număr), rezultate de obicei dintr-o împărțire la zero cu fdiv(), dintr-un log(0) sau dintr-un calcul pe date lipsă. JSON nu are aceste valori. Tratează cazul înainte: pune 0 sau null când împărțitorul e 0. Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in index.php on line 5 Scriptul a depășit limita de memorie (memory_limit, aici 128 MB). Cel mai des e o buclă infinită care adaugă într-un tablou, o recursivitate fără oprire sau încărcarea unui fișier ori a unui rezultat de bază de date uriaș deodată. Repară bucla sau procesează datele pe bucăți; mărirea limitei e ultima soluție. Î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.
