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

Fatal error: Uncaught JsonException: Recursion detected in index.php:18

Pe scurt

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

Greșit
PHP
<?php
$parinte = new stdClass();
$copil = new stdClass();
$copil->parinte = $parinte;
$parinte->copii = [$copil];
echo json_encode($parinte, JSON_THROW_ON_ERROR);
Corect
PHP
<?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

Greșit
PHP
<?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);
Corect
PHP
<?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ă tu

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":[]}]}.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
{"nume":"Haine","copii":[{"nume":"Geci","copii":[]}]}
Indiciu

jsonSerialize() întoarce ['nume' => ..., 'copii' => ...], fără parinte.

Alte forme ale mesajului

  • PHP Fatal error: Uncaught JsonException: Recursion detected in /var/www/html/index.php:18
  • Recursion detected
  • Fatal 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ăcere false.
  • „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

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