...
Eroare PHP · Mesaje Deprecated la upgrade de versiune

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

Pe scurt

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

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

Greșit
PHP
<?php
class Cos implements Serializable {
    public function serialize() { /* ... */ }
    public function unserialize($d) { /* ... */ }
}
Corect
PHP
<?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

Greșit
PHP
composer show vendor/pachet-vechi
Corect
PHP
composer update vendor/pachet-vechi

Mesajul care indică un fișier din vendor/ se repară prin actualizarea pachetului (sau înlocuirea lui), nu prin editarea codului de acolo.

Repară tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Produse după restaurare: Pix, Cană
Indiciu

Scoate implements Serializable; __serialize întoarce ['produse' => $this->produse], iar __unserialize le pune la loc.

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 / __unserialize doar 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ât serialize.
  • Ț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

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