Fatal error: Uncaught Exception: Serialization of 'Closure' is not allowed in index.php:6
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
<?php
$filtru = ['regula' => fn($p) => $p < 100];
$text = serialize($filtru);<?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
<?php
class Cos { public $calculTva; }
$c = new Cos();
$c->calculTva = fn($x) => $x * 1.19;
echo serialize($c);<?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
<?php
class Raport
{
public array $date = [1, 2];
public $formatare;
}
$r = new Raport();
$r->formatare = fn($v) => "$v lei";
serialize($r);<?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ă 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.
<?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";ieftine: 49, 99
Indiciu
Pune în tablou 'max' => 100 în loc de funcție; după unserialize scrie fn($p) => $p < $restaurat['max'].
Reparația
<?php
$filtru = [
'nume' => 'ieftine',
'max' => 100,
];
$salvat = serialize($filtru);
$restaurat = unserialize($salvat);
$regula = fn(float $pret): bool => $pret < $restaurat['max'];
$preturi = [49, 150, 99, 320];
$alese = array_filter($preturi, $regula);
echo $restaurat['nume'] . ': ' . implode(', ', $alese) . "\n";De ce merge
serialize nu poate transforma în text codul unei funcții anonime, de aceea a aruncat excepția chiar la salvare.
Acum se salvează doar datele ('max' => 100), care se serializează fără probleme. După unserialize, construiești funcția din pragul citit, iar array_filter păstrează prețurile mai mici de 100.
Alte forme ale mesajului
PHP Fatal error: Uncaught Exception: Serialization of 'Closure' is not allowed in [no active file]:0Fatal error: Uncaught Exception: Serialization of 'Generator' is not allowed in index.php:6Fatal 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
Warning: unserialize(): Error at offset 41 of 71 bytes in index.php on line 6 Textul dat lui unserialize() nu mai e un serialize() valid: a fost trunchiat (coloană prea scurtă în baza de date) sau modificat cu str_replace, iar lungimile s:NN: nu mai corespund. unserialize întoarce false. Nu edita textul serializat: deserializează, modifică datele, serializează la loc (sau folosește JSON). Fatal error: Uncaught Error: The script tried to call a method on an incomplete object. Please ensure that the class definition "Cos" of the object you are trying to operate on was loaded _before_ unserialize() gets called or provide an autoloader to load the class definition in index.php:6 Ai refăcut un obiect cu unserialize() (sau din $_SESSION) înainte ca PHP să cunoască clasa lui. Obiectul a devenit __PHP_Incomplete_Class, fără metode. Încarcă clasa (require sau autoloader-ul Composer) înainte de session_start() și de unserialize(). Deprecated: Cos implements the Serializable interface, which is deprecated. Implement __serialize() and __unserialize() instead (or in addition, if support for old PHP versions is necessary) in index.php on line 2 Din PHP 8.1, interfața Serializable (metodele serialize() și unserialize()) e Deprecated. Adaugă în clasă metodele __serialize(): array și __unserialize(array $date): void; dacă le ai, PHP le folosește pe ele și mesajul dispare. Când nu mai ai nevoie de PHP < 7.4, scoate Serializable. Î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.
