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

Fatal error: Class StocInsuficient cannot implement interface Throwable, extend Exception or Error instead in index.php on line 2

Pe scurt

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

Greșit
PHP
<?php
class StocInsuficient implements Throwable
{
}
Corect
PHP
<?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

Greșit
PHP
<?php
interface ExceptieMagazin extends Throwable {}
class StocInsuficient implements ExceptieMagazin {}
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
    }
}
După reparație, programul afișează
Comandă acceptată: Cană
Eroare: Stoc insuficient pentru Rucsac
Indiciu

Excepțiile proprii extind o clasă existentă, de ex. RuntimeException; constructorul ei setează mesajul.

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 5
  • Fatal 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 cu catch (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

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