...
Eroare PHP · Excepții, JSON și expresii regulate

Fatal error: Uncaught Error: Can only throw objects in index.php:5

Pe scurt

Ai scris throw urmat de un text, un număr sau null (de exemplu throw "Stoc insuficient";), dar PHP poate arunca doar obiecte de tip excepție. Creează o excepție cu mesajul tău: throw new Exception("Stoc insuficient"); sau o clasă mai specifică, de ex. InvalidArgumentException.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

throw aruncă o excepție, iar în PHP o excepție e un obiect care implementează interfața Throwable: Exception, Error sau o clasă derivată din ele. Obiectul are mesaj (getMessage()), cod, fișier, linie și stiva de apeluri, informații pe care catch și logurile le folosesc.

Dacă după throw vine un text (throw 'Eroare';), un număr sau null, PHP nu are ce excepție să arunce și în locul ei aruncă un Error cu mesajul Can only throw objects. Scriptul tău se oprește, iar mesajul tău nu apare nicăieri.

Se întâmplă când vii din JavaScript (unde throw 'text' e permis) sau când o variabilă care ar fi trebuit să conțină o excepție e null (throw $this->ultimaEroare;). Linia din mesaj e linia cu throw.

De ce apare: cauzele frecvente

1Text aruncat direct

Greșit
PHP
<?php
if ($stoc < $cantitate) {
    throw 'Stoc insuficient';
}
Corect
PHP
<?php
if ($stoc < $cantitate) {
    throw new RuntimeException('Stoc insuficient');
}

new RuntimeException('...') creează obiectul excepției, cu mesajul tău în getMessage().

2Variabilă de excepție care e null

Greșit
PHP
<?php
$eroare = null;
foreach ($pasi as $pas) {
    // ...
}
throw $eroare;
Corect
PHP
<?php
$eroare = null;
foreach ($pasi as $pas) {
    // ...
}
if ($eroare !== null) {
    throw $eroare;
}

Arunci variabila doar dacă chiar conține o excepție.

3Argument invalid semnalat cu un număr

Greșit
PHP
<?php
function seteazaVarsta(int $v): void
{
    if ($v < 0) {
        throw 400;
    }
}
Corect
PHP
<?php
function seteazaVarsta(int $v): void
{
    if ($v < 0) {
        throw new InvalidArgumentException('Vârsta nu poate fi negativă', 400);
    }
}

Codul numeric se dă ca al doilea argument al excepției și se citește cu getCode().

Repară tu

Repară eroarea, direct în pagină

Funcția retrage ar trebui să refuze retragerile mai mari decât soldul, iar codul de jos să afișeze mesajul, dar programul se oprește cu Uncaught Error: Can only throw objects. Repară throw, ca programul să afișeze Retras: 50 lei și Eroare: Sold insuficient.

Codul care dă eroarea
PHP
<?php
function retrage(float $sold, float $suma): float
{
    if ($suma > $sold) {
        throw 'Sold insuficient';
    }
    return $sold - $suma;
}

foreach ([50, 500] as $suma) {
    try {
        retrage(200, $suma);
        echo "Retras: $suma lei\n";
    } catch (RuntimeException $e) {
        echo 'Eroare: ' . $e->getMessage() . "\n";
    }
}
După reparație, programul afișează
Retras: 50 lei
Eroare: Sold insuficient
Indiciu

După throw trebuie un obiect: new RuntimeException('Sold insuficient').

Alte forme ale mesajului

  • PHP Fatal error: Uncaught Error: Can only throw objects in /var/www/html/index.php:5
  • Fatal error: Can only throw objects in index.php on line 5

Cum o eviți pe viitor

  • Aruncă mereu new ...Exception('mesaj'); alege clasa care descrie problema (InvalidArgumentException, RuntimeException, DomainException) sau creează-ți una proprie.
  • Pentru erori din domeniul aplicației, o clasă proprie (class StocInsuficient extends RuntimeException {}) se prinde mai ușor țintit.
  • Nu păstra excepții în variabile care pot fi null fără să verifici înainte de throw.

Întrebări frecvente

Ce clasă de excepție să folosesc?

InvalidArgumentException pentru date de intrare greșite, RuntimeException pentru probleme apărute la rulare (fișier lipsă, serviciu indisponibil), LogicException pentru greșeli de programare. Pentru reguli de business, o clasă proprie e cea mai clară.

Pot arunca un obiect oarecare, de exemplu un stdClass?

Nu. Obiectul trebuie să implementeze Throwable, adică să extindă Exception sau Error. Altfel primești Cannot throw objects that do not implement Throwable.

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.