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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mecanismul vechi de serializare personalizată cerea implements Serializable și două metode: serialize(), care întorcea un text, și unserialize($text). Avea probleme greu de evitat (referințe partajate, obiecte imbricate, securitate), așa că PHP 7.4 a introdus metodele magice __serialize(): array și __unserialize(array $date): void, care lucrează cu tablouri.
Din PHP 8.1, o clasă care implementează Serializable fără să aibă și __serialize / __unserialize primește acest mesaj la încărcarea clasei (de aceea linia e cea a declarației). Dacă ai ambele seturi, PHP folosește metodele noi și nu mai afișează nimic; de aici partea „or in addition”: poți păstra temporar și interfața veche pentru PHP mai vechi.
Mesajul apare des în biblioteci vechi din vendor/. Acolo soluția e actualizarea pachetului, nu editarea codului din vendor.
De ce apare: cauzele frecvente
1Doar interfața veche
<?php
class Cos implements Serializable {
private array $produse = [];
public function serialize() { return json_encode($this->produse); }
public function unserialize($d) { $this->produse = json_decode($d, true); }
}<?php
class Cos {
private array $produse = [];
public function __serialize(): array { return ['produse' => $this->produse]; }
public function __unserialize(array $d): void { $this->produse = $d['produse']; }
}Metodele noi lucrează direct cu un tablou; PHP se ocupă de transformarea în text.
2Compatibilitate temporară cu versiuni vechi
<?php
class Cos implements Serializable {
public function serialize() { /* ... */ }
public function unserialize($d) { /* ... */ }
}<?php
class Cos implements Serializable {
public function serialize() { return serialize($this->__serialize()); }
public function unserialize($d) { $this->__unserialize(unserialize($d)); }
public function __serialize(): array { /* ... */ return []; }
public function __unserialize(array $d): void { /* ... */ }
}Cu ambele seturi, PHP 7.4+ folosește metodele noi, iar mesajul nu mai apare.
3Biblioteca din vendor
composer show vendor/pachet-vechicomposer update vendor/pachet-vechiMesajul care indică un fișier din vendor/ se repară prin actualizarea pachetului (sau înlocuirea lui), nu prin editarea codului de acolo.
Repară eroarea, direct în pagină
Clasa Cos folosește interfața veche Serializable, iar codul afișează Deprecated: Cos implements the Serializable interface, which is deprecated. Înlocuiește interfața cu metodele __serialize(): array și __unserialize(array $date): void, ca programul să afișeze Produse după restaurare: Pix, Cană fără mesaje Deprecated.
<?php
class Cos implements Serializable
{
private array $produse = [];
public function adauga(string $p): void { $this->produse[] = $p; }
public function produse(): array { return $this->produse; }
public function serialize(): string { return json_encode($this->produse); }
public function unserialize(string $date): void { $this->produse = json_decode($date, true); }
}
$cos = new Cos();
$cos->adauga('Pix');
$cos->adauga('Cană');
$restaurat = unserialize(serialize($cos));
echo 'Produse după restaurare: ' . implode(', ', $restaurat->produse()) . "\n";Produse după restaurare: Pix, Cană
Indiciu
Scoate implements Serializable; __serialize întoarce ['produse' => $this->produse], iar __unserialize le pune la loc.
Reparația
<?php
class Cos
{
private array $produse = [];
public function adauga(string $p): void { $this->produse[] = $p; }
public function produse(): array { return $this->produse; }
public function __serialize(): array { return ['produse' => $this->produse]; }
public function __unserialize(array $date): void { $this->produse = $date['produse']; }
}
$cos = new Cos();
$cos->adauga('Pix');
$cos->adauga('Cană');
$restaurat = unserialize(serialize($cos));
echo 'Produse după restaurare: ' . implode(', ', $restaurat->produse()) . "\n";De ce merge
O clasă care implementează Serializable fără metodele noi primește din PHP 8.1 mesajul Deprecated, chiar la declarare.
Cu __serialize(), serialize($cos) folosește tabloul întors de metodă, iar unserialize creează un obiect nou și îi dă tabloul prin __unserialize(). Nu mai trebuie să produci tu un text, deci dispare și json_encode / json_decode.
Alte forme ale mesajului
PHP Deprecated: Money implements the Serializable interface, which is deprecated. Implement __serialize() and __unserialize() instead (or in addition, if support for old PHP versions is necessary) in /var/www/html/vendor/vechi/money/src/Money.php on line 12
Cum o eviți pe viitor
- În cod nou, nu folosi
Serializable; scrie__serialize/__unserializedoar dacă ai nevoie de control asupra datelor serializate. - Pentru date care pleacă din aplicație (cache, API, cozi), JSON (
JsonSerializable) e mai sigur și mai portabil decâtserialize. - Ține pachetele Composer la zi: mesajele Deprecated din
vendor/sunt un semn că pachetul e vechi.
Întrebări frecvente
Pot ignora mesajul?
Codul funcționează în continuare, dar Serializable va fi eliminată într-o versiune majoră viitoare. În plus, framework-urile în mod de dezvoltare transformă adesea Deprecated în excepții.
Datele serializate cu metoda veche se mai pot citi?
Textele vechi au formatul C:3:"Cos":... și sunt citite cu unserialize() din interfața veche. Cele noi au formatul obișnuit O:3:"Cos":.... Dacă ai date vechi salvate, păstrează temporar ambele seturi de metode, până le reserializezi.
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). Deprecated: Return type of Colectie::getIterator() should either be compatible with IteratorAggregate::getIterator(): Traversable, or the #[\ReturnTypeWillChange] attribute should be used to temporarily suppress the notice in index.php on line 9 Clasa ta implementează o interfață din PHP (IteratorAggregate, Countable, ArrayAccess, JsonSerializable, Iterator), dar metoda nu are tipul de retur cerut din PHP 8.1. Adaugă tipul din mesaj: public function getIterator(): Traversable, count(): int, jsonSerialize(): mixed. Atributul #[\ReturnTypeWillChange] doar ascunde mesajul. Deprecated: Creation of dynamic property Produs::$culoare is deprecated in index.php on line 9 Atribui o valoare unei proprietăți care nu e declarată în clasă, iar din PHP 8.2 asta e depreciat. Declară proprietatea în clasă (de exemplu public string $culoare;) sau verifică dacă n-ai scris greșit numele. Î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.
