Fatal error: Uncaught Error: Can only throw objects in index.php:5
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
<?php
if ($stoc < $cantitate) {
throw 'Stoc insuficient';
}<?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
<?php
$eroare = null;
foreach ($pasi as $pas) {
// ...
}
throw $eroare;<?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
<?php
function seteazaVarsta(int $v): void
{
if ($v < 0) {
throw 400;
}
}<?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ă 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.
<?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";
}
}Retras: 50 lei Eroare: Sold insuficient
Indiciu
După throw trebuie un obiect: new RuntimeException('Sold insuficient').
Reparația
<?php
function retrage(float $sold, float $suma): float
{
if ($suma > $sold) {
throw new RuntimeException('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";
}
}De ce merge
throw 'Sold insuficient' încerca să arunce un text. PHP aruncă doar obiecte Throwable, așa că în locul excepției tale a apărut un Error („Can only throw objects”), pe care catch (RuntimeException $e) nu-l prinde.
new RuntimeException('Sold insuficient') e o excepție adevărată: catch o prinde, iar getMessage() întoarce textul dat la creare.
Alte forme ale mesajului
PHP Fatal error: Uncaught Error: Can only throw objects in /var/www/html/index.php:5Fatal 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
nullfără să verifici înainte dethrow.
Î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
Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in index.php:6 Codul aruncă o excepție (cu throw) pe care nu o prinde nimeni, așa că scriptul se oprește. Pune apelul care poate eșua într-un try și tratează excepția în catch (de exemplu afișezi mesajul și continui). Fatal error: Class StocInsuficient cannot implement interface Throwable, extend Exception or Error instead in index.php on line 2 Ai încercat să creezi o excepție proprie cu class StocInsuficient implements Throwable. Throwable nu poate fi implementată direct de clasele tale. Extinde o clasă existentă: class StocInsuficient extends Exception (sau RuntimeException, InvalidArgumentException). Fatal error: Cannot use try without catch or finally in index.php on line 2 Ai un bloc try { } care nu e urmat de niciun catch și niciun finally, de obicei pentru că l-ai șters, l-ai mutat sau ai pus cod între try și catch. Adaugă imediat după try un catch (Exception $e) { } sau un finally { }. Î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.
