...
Eroare PHP · Headere, sesiuni și fișiere incluse

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

Pe scurt

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

Greșit
PHP
<?php
session_start();
require __DIR__ . '/vendor/autoload.php';
echo $_SESSION['cos']->total();
Corect
PHP
<?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ă

Greșit
PHP
<?php
$cos = unserialize(file_get_contents('cache/cos.txt'));
$cos->total();
Corect
PHP
<?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

Greșit
PHP
<?php
// în sesiune: O:3:"Cos":...
namespace Magazin;
class Cos {}
session_start();
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Total: 200 lei
Indiciu

Clasa trebuie definită (sau inclusă) înainte de linia cu unserialize.

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:12
  • Warning: 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 6
  • object(__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 de session_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_dump pe 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();.

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