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).
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
<?php
function scoate(int $stoc, int $cant): int {
if ($cant > $stoc) throw new Exception('Stoc insuficient');
return $stoc - $cant;
}
echo scoate(2, 5);<?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ă
<?php
try {
throw new InvalidArgumentException('Email invalid');
} catch (RuntimeException $e) {
echo $e->getMessage();
}<?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
<?php
try {
echo intdiv(10, 0);
} catch (Exception $e) {
echo 'Eroare';
}<?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ă 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.
<?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";
}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().
Reparația
<?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]) {
try {
$ramas = $depozit->scoate($produs, $cantitate);
echo "$produs: livrat $cantitate, rămas $ramas\n";
} catch (Exception $e) {
echo "Eroare: " . $e->getMessage() . "\n";
}
}De ce merge
throw întrerupe imediat metoda și caută în sus un catch potrivit. Fără niciunul, excepția ajunge la nivelul cel mai de sus, PHP afișează Uncaught Exception și oprește tot, deci comanda pentru pix nu mai era procesată.
Cu try/catch în buclă, excepția comenzii de rucsac e prinsă și transformată într-un mesaj, iar bucla trece la comanda următoare. Linia echo cu „livrat” e în try, după apel, așa că nu se execută pentru comanda eșuată. Metoda scoate rămâne neschimbată: ea doar semnalează problema, iar codul care o apelează decide ce face.
Alte forme ale mesajului
PHP Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in /var/www/html/src/Depozit.php:6Fatal error: Uncaught InvalidArgumentException: Email invalid in index.php:8Fatal error: Uncaught PDOException: SQLSTATE[HY000] [2002] Connection refused in db.php:4Fatal 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 (
InvalidArgumentExceptionsau excepții proprii), ca să le prinzi selectiv. - Nu prinde excepții doar ca să le ascunzi cu un
catchgol. - Î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
Fatal error: Uncaught DivisionByZeroError: Division by zero in index.php:4 Împarți un număr la zero, de obicei la o variabilă care a ajuns 0 (o listă goală, un câmp necompletat). Verifică împărțitorul înainte de împărțire sau prinde DivisionByZeroError cu try/catch. Fatal error: Uncaught JsonException: Syntax error in index.php:4 Textul dat lui json_decode (cu JSON_THROW_ON_ERROR) nu e JSON valid: ghilimele simple, chei fără ghilimele, virgulă după ultimul element sau text gol. Corectează JSON-ul sau prinde JsonException și tratează datele invalide. Fatal error: Uncaught UnhandledMatchError: Unhandled match case 'anulata' in index.php:4 Expresia match a primit o valoare care nu se potrivește cu niciun braț și nu are default. Adaugă brațul lipsă sau un braț default => ..., care tratează orice altă valoare. Î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.
