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

Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in index.php:6

Pe scurt

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

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

Ce înseamnă

Uncaught înseamnă „neprinsă”: o excepție a fost aruncată (de codul tău cu throw new Exception(...) sau de o bibliotecă, de exemplu PDOException, JsonException, InvalidArgumentException) și a urcat prin toate funcțiile apelante fără să întâlnească un catch potrivit. Când ajunge la nivelul cel mai de sus, PHP afișează mesajul, stiva de apeluri și oprește scriptul.

Mesajul are trei părți: clasa excepției (Exception), mesajul ei (Stoc insuficient pentru Rucsac) și locul unde a fost aruncată (index.php:6). Sub el, Stack trace arată drumul: #0 index.php(14): Depozit->scoate('Rucsac', 3) înseamnă că linia 14 a apelat metoda care a aruncat.

Excepțiile nu sunt bug-uri în sine: sunt felul în care codul spune „nu pot continua”. Bug-ul e că nimeni nu tratează situația.

De ce apare: cauzele frecvente

1Apel fără try/catch

Greșit
PHP
<?php
function scoate(int $stoc, int $cant): int {
    if ($cant > $stoc) throw new Exception('Stoc insuficient');
    return $stoc - $cant;
}
echo scoate(2, 5);
Corect
PHP
<?php
function scoate(int $stoc, int $cant): int {
    if ($cant > $stoc) throw new Exception('Stoc insuficient');
    return $stoc - $cant;
}
try {
    echo scoate(2, 5);
} catch (Exception $e) {
    echo 'Eroare: ' . $e->getMessage();
}

catch prinde excepția și o transformă într-un mesaj, iar scriptul continuă.

2catch pentru altă clasă

Greșit
PHP
<?php
try {
    throw new InvalidArgumentException('Email invalid');
} catch (RuntimeException $e) {
    echo $e->getMessage();
}
Corect
PHP
<?php
try {
    throw new InvalidArgumentException('Email invalid');
} catch (InvalidArgumentException $e) {
    echo $e->getMessage();
}

catch prinde doar clasa indicată și subclasele ei. InvalidArgumentException nu e un RuntimeException.

3Error prinsă ca Exception

Greșit
PHP
<?php
try {
    echo intdiv(10, 0);
} catch (Exception $e) {
    echo 'Eroare';
}
Corect
PHP
<?php
try {
    echo intdiv(10, 0);
} catch (Throwable $e) {
    echo 'Eroare: ' . $e->getMessage();
}

Erorile PHP (Error, TypeError, DivisionByZeroError) nu sunt Exception. Throwable le prinde pe toate.

Repară tu

Repară eroarea, direct în pagină

Metoda scoate a depozitului aruncă o excepție când stocul nu ajunge. La a doua comandă excepția nu e prinsă și scriptul se oprește cu Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac. Pune procesarea fiecărei comenzi într-un try/catch, ca programul să afișeze Caiet: livrat 3, rămas 7, Eroare: Stoc insuficient pentru Rucsac și Pix: livrat 5, rămas 15.

Codul care dă eroarea
PHP
<?php
class Depozit
{
    private array $stoc = ['Caiet' => 10, 'Rucsac' => 1, 'Pix' => 20];

    public function scoate(string $produs, int $cantitate): int
    {
        if ($cantitate > $this->stoc[$produs]) {
            throw new Exception("Stoc insuficient pentru $produs");
        }
        $this->stoc[$produs] -= $cantitate;
        return $this->stoc[$produs];
    }
}

$depozit = new Depozit();
$comenzi = [['Caiet', 3], ['Rucsac', 2], ['Pix', 5]];

foreach ($comenzi as [$produs, $cantitate]) {
    $ramas = $depozit->scoate($produs, $cantitate);
    echo "$produs: livrat $cantitate, rămas $ramas\n";
}
După reparație, programul afișează
Caiet: livrat 3, rămas 7
Eroare: Stoc insuficient pentru Rucsac
Pix: livrat 5, rămas 15
Indiciu

try încadrează apelul care poate eșua, iar catch (Exception $e) afișează $e->getMessage().

Alte forme ale mesajului

  • PHP Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in /var/www/html/src/Depozit.php:6
  • Fatal error: Uncaught InvalidArgumentException: Email invalid in index.php:8
  • Fatal error: Uncaught PDOException: SQLSTATE[HY000] [2002] Connection refused in db.php:4
  • Fatal error: Uncaught StocInsuficientException: Stoc insuficient pentru Rucsac in index.php:6

Cum o eviți pe viitor

  • Prinde excepțiile acolo unde știi ce să faci cu ele: afișezi un mesaj, încerci altă variantă, anulezi operația.
  • Folosește clase de excepții specifice (InvalidArgumentException sau excepții proprii), ca să le prinzi selectiv.
  • Nu prinde excepții doar ca să le ascunzi cu un catch gol.
  • Într-o aplicație, pune un handler global (set_exception_handler) care scrie în log și afișează o pagină de eroare prietenoasă.

Întrebări frecvente

Care e diferența dintre Exception și Error?

Exception e pentru situații pe care codul le poate anticipa (date invalide, stoc insuficient, conexiune eșuată). Error e pentru greșeli de programare detectate de PHP (TypeError, apel de funcție inexistentă). Ambele implementează Throwable.

Cum citesc Stack trace?

De sus în jos, de la locul aruncării spre începutul programului. Fiecare rând #N fisier(linie): functie(argumente) e un apel. Caută primul rând din codul tău, nu din biblioteci.

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.