...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught Error: Object of class Produs could not be converted to string in index.php:9

Pe scurt

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

Greșit
PHP
<?php
class Produs {
    function __construct(public string $nume) {}
}
$p = new Produs('Caiet');
echo "Ai cumpărat: $p";
Corect
PHP
<?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

Greșit
PHP
<?php
class Bani {
    function __construct(public float $suma) {}
}
echo 'Total: ' . new Bani(12.5);
Corect
PHP
<?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

Greșit
PHP
<?php
enum Status: string { case Platita = 'plătită'; }
echo 'Status: ' . Status::Platita;
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Rezultat: 3/4
Jumătate: 1/2
Indiciu

Metoda __toString(): string trebuie să întoarcă un text, iar PHP o apelează automat la echo.

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Object of class DateTime could not be converted to string in index.php:5
  • Fatal error: Uncaught Error: Object of class stdClass could not be converted to string in index.php:5
  • Fatal error: Uncaught Error: Object of class Status could not be converted to string in index.php:5
  • Recoverable 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ă proprie eticheta().
  • Pentru depanare folosește var_dump($obiect) sau print_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

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