Fatal error: Uncaught Error: Object of class Produs could not be converted to string in index.php:9
Afișezi sau concatenezi un obiect ca pe un text, dar clasa lui nu are metoda __toString(). Afișează o proprietate a obiectului ($p->nume) sau adaugă clasei metoda public function __toString(): string.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Când pui un obiect într-un context de text (echo $p, "Produs: $p", 'x' . $p, strlen($p)), PHP trebuie să-l transforme în string. Asta merge doar dacă clasa definește metoda magică __toString(). Altfel aruncă Error: Object of class Produs could not be converted to string.
Cel mai des ai vrut de fapt să afișezi o proprietate ($p->nume) și ai uitat-o, sau ai un obiect acolo unde credeai că e un text: un DateTime (folosește ->format('d.m.Y')), un enum (folosește ->value sau ->name; enum-urile nu pot avea __toString), un obiect stdClass din json_decode.
Numele clasei din mesaj te ajută: dacă e DateTime, stdClass sau numele unui enum, știi imediat ce să folosești în loc.
De ce apare: cauzele frecvente
1Obiect afișat direct
<?php
class Produs {
function __construct(public string $nume) {}
}
$p = new Produs('Caiet');
echo "Ai cumpărat: $p";<?php
class Produs {
function __construct(public string $nume) {}
}
$p = new Produs('Caiet');
echo "Ai cumpărat: {$p->nume}";Afișezi proprietatea text, nu obiectul întreg.
2Clasă care ar trebui să știe să se afișeze
<?php
class Bani {
function __construct(public float $suma) {}
}
echo 'Total: ' . new Bani(12.5);<?php
class Bani {
function __construct(public float $suma) {}
function __toString(): string {
return number_format($this->suma, 2) . ' lei';
}
}
echo 'Total: ' . new Bani(12.5);__toString() definește cum arată obiectul ca text; PHP o apelează automat.
3Enum sau DateTime afișat
<?php
enum Status: string { case Platita = 'plătită'; }
echo 'Status: ' . Status::Platita;<?php
enum Status: string { case Platita = 'plătită'; }
echo 'Status: ' . Status::Platita->value;Enum-urile nu se convertesc în text; valoarea e în ->value (pentru enum-uri cu valori).
Repară eroarea, direct în pagină
Clasa Fractie reprezintă o fracție, iar scriptul o afișează direct cu echo, așa că se oprește cu Error: Object of class Fractie could not be converted to string. Adaugă clasei metoda __toString(), care întoarce fracția sub forma numărător/numitor, ca programul să afișeze Rezultat: 3/4 și Jumătate: 1/2.
<?php
class Fractie
{
public function __construct(
public int $numarator,
public int $numitor,
) {}
}
$f = new Fractie(3, 4);
echo "Rezultat: " . $f . "\n";
echo "Jumătate: " . new Fractie(1, 2) . "\n";Rezultat: 3/4 Jumătate: 1/2
Indiciu
Metoda __toString(): string trebuie să întoarcă un text, iar PHP o apelează automat la echo.
Reparația
<?php
class Fractie
{
public function __construct(
public int $numarator,
public int $numitor,
) {}
public function __toString(): string
{
return "{$this->numarator}/{$this->numitor}";
}
}
$f = new Fractie(3, 4);
echo "Rezultat: " . $f . "\n";
echo "Jumătate: " . new Fractie(1, 2) . "\n";De ce merge
Operatorul . are nevoie de texte, iar PHP nu știe singur cum să scrie un obiect Fractie ca text. Fără __toString(), conversia e imposibilă și PHP aruncă Error.
__toString() este o metodă magică: n-o apelezi tu, ci PHP o apelează automat oricând obiectul e folosit ca text (în echo, concatenare, interpolare, strlen). Aici întoarce numărătorul și numitorul despărțite de /. Din PHP 8, orice clasă cu __toString() implementează automat și interfața Stringable.
Alte forme ale mesajului
Fatal error: Uncaught Error: Object of class DateTime could not be converted to string in index.php:5Fatal error: Uncaught Error: Object of class stdClass could not be converted to string in index.php:5Fatal error: Uncaught Error: Object of class Status could not be converted to string in index.php:5Recoverable fatal error: Object of class Produs could not be converted to string in index.php on line 9
Cum o eviți pe viitor
- Adaugă
__toString()claselor-valoare care au o formă text naturală (bani, adrese, nume complete). - Pentru date calendaristice, folosește întotdeauna
->format(...). - Pentru enum-uri,
->value(valoarea) sau->name(numele cazului), ori o metodă proprieeticheta(). - Pentru depanare folosește
var_dump($obiect)sauprint_r($obiect), care știu să afișeze orice obiect.
Întrebări frecvente
Pot adăuga __toString unui enum?
Nu, enum-urile nu au voie să definească __toString(). Adaugă o metodă normală, de exemplu public function eticheta(): string, și apeleaz-o explicit.
De ce print_r merge, dar echo nu?
print_r și var_dump sunt funcții de depanare care știu să afișeze structura oricărui obiect. echo cere un text, deci are nevoie de __toString().
Erori înrudite
Warning: Array to string conversion in index.php on line 3 Încerci să afișezi sau să lipești un tablou ca și cum ar fi text, iar PHP scrie doar cuvântul Array. Afișează elementele lui: implode(', ', $tablou) pentru o listă, print_r() sau json_encode() pentru depanare. Fatal error: Uncaught Error: Call to undefined method Produs::getPret() in index.php:10 Clasa obiectului nu are metoda pe care o apelezi: numele e greșit, metoda e în altă clasă sau ai un obiect de alt tip decât credeai. Verifică numele metodei în clasă (și clasa din mesaj). Warning: Undefined property: Produs::$pret in index.php on line 9 Obiectul nu are proprietatea pe care o citești: numele e scris greșit sau proprietatea nu e declarată în clasă. Verifică numele exact al proprietății (și majusculele) în definiția clasei. Î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.
