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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În PHP, tot ce poate fi aruncat cu throw implementează interfața Throwable. Doar că Throwable e rezervată: o implementează numai cele două clase de bază ale limbajului, Exception (pentru erorile pe care aplicația le poate trata) și Error (pentru erorile interne, precum TypeError). Mesajul îți spune exact ce să faci: extinde Exception sau Error.
Motivul: o excepție are nevoie de date pe care le completează PHP (fișierul, linia, stiva de apeluri). Clasele de bază le au deja; o clasă scrisă de la zero nu le-ar putea avea.
Pentru excepțiile aplicației tale extinde aproape mereu Exception sau o subclasă (RuntimeException, DomainException, InvalidArgumentException). Error e pentru erorile limbajului.
De ce apare: cauzele frecvente
1Excepție proprie care implementează Throwable
<?php
class StocInsuficient implements Throwable
{
}<?php
class StocInsuficient extends RuntimeException
{
}Extinzi o clasă de excepție existentă și primești gratis mesaj, cod, linie și stiva de apeluri.
2Interfață proprie pentru excepțiile modulului
<?php
interface ExceptieMagazin extends Throwable {}
class StocInsuficient implements ExceptieMagazin {}<?php
interface ExceptieMagazin extends Throwable {}
class StocInsuficient extends RuntimeException implements ExceptieMagazin {}O interfață proprie poate extinde Throwable, ca să prinzi toate excepțiile modulului cu un singur catch. Clasa concretă trebuie totuși să extindă Exception.
Repară eroarea, direct în pagină
Clasa StocInsuficient ar trebui să fie o excepție proprie, dar fișierul nu pornește: Fatal error: Class StocInsuficient cannot implement interface Throwable, extend Exception or Error instead. Repară declarația clasei, ca programul să afișeze Comandă acceptată: Cană și Eroare: Stoc insuficient pentru Rucsac.
<?php
class StocInsuficient implements Throwable
{
}
function comanda(string $produs, int $stoc): void
{
if ($stoc === 0) {
throw new StocInsuficient("Stoc insuficient pentru $produs");
}
echo "Comandă acceptată: $produs\n";
}
foreach (['Cană' => 3, 'Rucsac' => 0] as $produs => $stoc) {
try {
comanda($produs, $stoc);
} catch (StocInsuficient $e) {
echo 'Eroare: ' . $e->getMessage() . "\n";
}
}Comandă acceptată: Cană Eroare: Stoc insuficient pentru Rucsac
Indiciu
Excepțiile proprii extind o clasă existentă, de ex. RuntimeException; constructorul ei setează mesajul.
Reparația
<?php
class StocInsuficient extends RuntimeException
{
}
function comanda(string $produs, int $stoc): void
{
if ($stoc === 0) {
throw new StocInsuficient("Stoc insuficient pentru $produs");
}
echo "Comandă acceptată: $produs\n";
}
foreach (['Cană' => 3, 'Rucsac' => 0] as $produs => $stoc) {
try {
comanda($produs, $stoc);
} catch (StocInsuficient $e) {
echo 'Eroare: ' . $e->getMessage() . "\n";
}
}De ce merge
Throwable poate fi implementată doar de Exception și Error, clasele de bază ale PHP, fiindcă ele completează automat fișierul, linia și stiva de apeluri. O clasă proprie nu are voie s-o implementeze direct.
extends RuntimeException moștenește constructorul cu mesaj și metoda getMessage(), așa că new StocInsuficient("...") funcționează fără cod în plus, iar catch (StocInsuficient $e) prinde exact această excepție.
Alte forme ale mesajului
PHP Fatal error: Class App\Exceptions\StocInsuficient cannot implement interface Throwable, extend Exception or Error instead in /var/www/html/src/Exceptions/StocInsuficient.php on line 5Fatal error: Uncaught Error: Cannot throw objects that do not implement Throwable in index.php:6
Cum o eviți pe viitor
- Pentru excepții proprii:
class NumeException extends RuntimeException {}(sau altă subclasă potrivită). - Grupează excepțiile unui modul cu o interfață marker care extinde
Throwableși prinde-le cucatch (ExceptieMagazin $e). - Dă nume care descriu problema:
StocInsuficient,ComandaNegasita. - Păstrează excepțiile proprii într-un folder separat (de ex.
src/Exceptions), ca să fie ușor de găsit și refolosit.
Întrebări frecvente
Exception sau Error: pe care să-l extind?
Exception, pentru tot ce ține de aplicația ta. Error și subclasele lui (TypeError, ValueError) sunt folosite de PHP pentru greșeli de programare și erori interne.
Pot adăuga câmpuri proprii în excepție?
Da. De exemplu public function __construct(public readonly string $produs) { parent::__construct("Stoc insuficient pentru $produs"); }. Nu uita să apelezi parent::__construct(), ca mesajul să fie setat.
Erori înrudite
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. 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: Cerc cannot implement Forma - it is not an interface in index.php on line 7 Ai folosit implements cu o clasă (sau extends cu o interfață). implements se folosește doar pentru interfețe, iar extends pentru clase. Schimbă cuvântul cheie sau declară Forma ca interface. Î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.
