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().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când serializezi un obiect, PHP salvează doar numele clasei și valorile proprietăților, nu și codul metodelor. La unserialize() caută clasa după nume. Dacă în acel moment clasa nu e încărcată (nu ai făcut require, autoloader-ul nu e pornit), PHP creează un obiect special, __PHP_Incomplete_Class, care păstrează datele, dar nu are nicio metodă.
Primul apel de metodă pe el dă eroarea lungă: The script tried to call a method on an incomplete object... cu numele clasei lipsă ("Cos"). Accesul la proprietăți dă un Warning asemănător.
Cel mai des se întâmplă cu sesiunile: session_start() deserializează automat tot ce e în $_SESSION. Dacă pui un obiect Cos în sesiune, iar pe altă pagină apelezi session_start() înainte de require 'Cos.php' (sau înainte de vendor/autoload.php), obiectul iese incomplet.
De ce apare: cauzele frecvente
1session_start() înainte de încărcarea clasei
<?php
session_start();
require __DIR__ . '/vendor/autoload.php';
echo $_SESSION['cos']->total();<?php
require __DIR__ . '/vendor/autoload.php';
session_start();
echo $_SESSION['cos']->total();Autoloader-ul e pornit înainte ca sesiunea să fie deserializată, deci PHP găsește clasa Cos.
2Date din cache fără clasa definită
<?php
$cos = unserialize(file_get_contents('cache/cos.txt'));
$cos->total();<?php
require __DIR__ . '/src/Cos.php';
$cos = unserialize(file_get_contents('cache/cos.txt'));
$cos->total();Clasa trebuie să existe în momentul unserialize, nu doar la apelul metodei.
3Clasa a fost redenumită sau mutată în alt namespace
<?php
// în sesiune: O:3:"Cos":...
namespace Magazin;
class Cos {}
session_start();<?php
// salvează în sesiune doar date simple
$_SESSION['cos'] = ['produse' => [120, 80]];Numele complet al clasei (cu namespace) trebuie să fie identic; datele simple nu au această problemă.
Repară eroarea, direct în pagină
La cererea anterioară, coșul a fost salvat serializat (ca în sesiune), dar scriptul de acum îl deserializează fără ca clasa Cos să existe și se oprește cu The script tried to call a method on an incomplete object. Definește clasa Cos (cu proprietatea produse și metoda total() care adună prețurile) înainte de unserialize, ca programul să afișeze Total: 200 lei.
<?php
// Obiectul salvat la cererea anterioară (în sesiune / cache):
$salvat = 'O:3:"Cos":1:{s:7:"produse";a:2:{i:0;i:120;i:1;i:80;}}';
$cos = unserialize($salvat);
echo 'Total: ' . $cos->total() . " lei\n";Total: 200 lei
Indiciu
Clasa trebuie definită (sau inclusă) înainte de linia cu unserialize.
Reparația
<?php
class Cos
{
public array $produse = [];
public function total(): int
{
return array_sum($this->produse);
}
}
// Obiectul salvat la cererea anterioară (în sesiune / cache):
$salvat = 'O:3:"Cos":1:{s:7:"produse";a:2:{i:0;i:120;i:1;i:80;}}';
$cos = unserialize($salvat);
echo 'Total: ' . $cos->total() . " lei\n";De ce merge
Textul serializat conține doar numele clasei (Cos) și proprietatea produse. Fără clasă, unserialize a creat un __PHP_Incomplete_Class, care nu are metoda total().
Cu clasa definită înainte, unserialize construiește un obiect Cos adevărat, cu metodele lui, iar total() adună 120 și 80. Într-un proiect real asta înseamnă autoloader-ul încărcat înainte de session_start().
Alte forme ale mesajului
PHP Fatal error: Uncaught Error: The script tried to call a method on an incomplete object. Please ensure that the class definition "App\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 /var/www/html/cos.php:12Warning: main(): The script tried to access a property 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 on line 6object(__PHP_Incomplete_Class)#1 (2) { ["__PHP_Incomplete_Class_Name"]=> string(3) "Cos" }
Cum o eviți pe viitor
- Pune
require 'vendor/autoload.php'(sau include-urile claselor) pe prima linie a fiecărui script, înainte desession_start(). - În sesiune păstrează de preferință date simple (id-uri, tablouri), nu obiecte întregi.
- Dacă redenumești sau muți o clasă, golește sesiunile și cache-ul vechi.
var_dumppe un obiect suspect: dacă vezi__PHP_Incomplete_Class, problema e ordinea încărcării.
Întrebări frecvente
De ce merge pe o pagină și pe alta nu?
Pentru că pe prima pagină clasa e încărcată înainte de session_start(), iar pe cealaltă nu. Compară ordinea include-urilor la începutul celor două scripturi.
Pot recupera datele dintr-un obiect incomplet?
Da, proprietățile există încă. Cel mai simplu e să încarci clasa și să refaci obiectul; altfel le poți citi transformând obiectul în tablou cu (array).
Erori înrudite
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. 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: Class "Produs" not found in index.php:9 PHP nu găsește definiția clasei: numele e scris greșit, fișierul clasei nu e inclus (sau autoload-ul Composer nu e configurat), ori clasa e într-un namespace și lipsește use. Verifică numele, require-ul sau use-ul. Notice: session_start(): Ignoring session_start() because a session is already active (started from index.php on line 2) in config.php on line 3 session_start() e apelat a doua oară în aceeași cerere, de obicei pentru că și fișierul principal, și un fișier inclus (config.php, header.php) îl apelează. A doua oară nu face nimic. Apelează-l într-un singur loc sau protejează apelul: if (session_status() === PHP_SESSION_NONE) session_start();. Î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.
