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

Fatal error: Uncaught Exception: Serialization of 'Closure' is not allowed in index.php:6

Pe scurt

Ai încercat să serializezi (serialize(), sesiune, cache, coadă de joburi) date care conțin o funcție anonimă (Closure). Codul unei funcții nu se poate transforma în text. Salvează doar datele (de exemplu pragul 100) și reconstruiește funcția după ce le citești.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

serialize() transformă valori PHP în text, ca să poată fi salvate (în sesiune, într-un fișier de cache, într-o coadă de joburi) și refăcute mai târziu cu unserialize(). Funcțiile anonime (function () {...}, fn() => ...) sunt obiecte de tip Closure, iar PHP nu le poate serializa: aruncă Exception: Serialization of 'Closure' is not allowed.

Eroarea apare des indirect: pui în $_SESSION un obiect care are o proprietate cu un callback, trimiți într-o coadă (Laravel, Symfony Messenger) un job care ține o closure, sau cache-uiești un tablou de reguli scrise ca funcții. Uneori mesajul apare la sfârșitul cererii, când PHP salvează sesiunea, nu pe linia ta.

Caută în stiva de apeluri ce valoare se serializa și ce proprietate a ei e o closure.

De ce apare: cauzele frecvente

1Tablou de configurare cu o funcție în el

Greșit
PHP
<?php
$filtru = ['regula' => fn($p) => $p < 100];
$text = serialize($filtru);
Corect
PHP
<?php
$filtru = ['max' => 100];
$text = serialize($filtru);
$regula = fn($p) => $p < unserialize($text)['max'];

Salvezi doar datele (pragul), iar funcția o construiești la nevoie.

2Obiect cu callback pus în sesiune

Greșit
PHP
<?php
class Cos { public $calculTva; }
$c = new Cos();
$c->calculTva = fn($x) => $x * 1.19;
echo serialize($c);
Corect
PHP
<?php
class Cos
{
    public float $cotaTva = 0.19;
    public function cuTva(float $x): float { return $x * (1 + $this->cotaTva); }
}
echo serialize(new Cos());

Comportamentul stă într-o metodă a clasei, iar obiectul serializat conține doar date.

3Excludere explicită la serializare

Greșit
PHP
<?php
class Raport
{
    public array $date = [1, 2];
    public $formatare;
}
$r = new Raport();
$r->formatare = fn($v) => "$v lei";
serialize($r);
Corect
PHP
<?php
class Raport
{
    public array $date = [1, 2];
    public $formatare;
    public function __serialize(): array { return ['date' => $this->date]; }
    public function __unserialize(array $d): void { $this->date = $d['date']; }
}
$r = new Raport();
$r->formatare = fn($v) => "$v lei";
echo serialize($r);

__serialize alege ce se salvează și lasă afară closure-ul.

Repară tu

Repară eroarea, direct în pagină

Programul salvează un filtru de produse cu serialize(), dar filtrul conține o funcție, iar programul se oprește cu Exception: Serialization of 'Closure' is not allowed. Salvează doar pragul de preț ('max' => 100) și construiește funcția după unserialize, ca programul să afișeze ieftine: 49, 99.

Codul care dă eroarea
PHP
<?php
$filtru = [
    'nume' => 'ieftine',
    'regula' => fn(float $pret): bool => $pret < 100,
];
$salvat = serialize($filtru);
$restaurat = unserialize($salvat);

$preturi = [49, 150, 99, 320];
$alese = array_filter($preturi, $restaurat['regula']);
echo $restaurat['nume'] . ': ' . implode(', ', $alese) . "\n";
După reparație, programul afișează
ieftine: 49, 99
Indiciu

Pune în tablou 'max' => 100 în loc de funcție; după unserialize scrie fn($p) => $p < $restaurat['max'].

Alte forme ale mesajului

  • PHP Fatal error: Uncaught Exception: Serialization of 'Closure' is not allowed in [no active file]:0
  • Fatal error: Uncaught Exception: Serialization of 'Generator' is not allowed in index.php:6
  • Fatal error: Uncaught Exception: Serialization of 'PDO' is not allowed in index.php:8

Cum o eviți pe viitor

  • În sesiune, cache și cozi pune doar date simple: tablouri, numere, texte, obiecte fără callback-uri.
  • Comportamentul ține-l în metode ale claselor, nu în proprietăți cu closure-uri.
  • Pentru obiecte cu părți care nu se pot salva (conexiuni, closure-uri), implementează __serialize / __unserialize.
  • Același lucru e valabil pentru PDO, generatoare și alte resurse (vezi variantele).

Întrebări frecvente

De ce apare „in [no active file]:0”?

Pentru că PHP serializează sesiunea după ce scriptul s-a terminat, deci nu mai există o linie de cod curentă. Caută ce ai pus în $_SESSION.

Există vreo bibliotecă ce serializează closure-uri?

Da, de exemplu laravel/serializable-closure le salvează ca text cu codul sursă. Dar pentru majoritatea cazurilor e mai simplu și mai sigur să salvezi doar date.

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.