PHP Izjeme (Exceptions)

Izjema (Exception) je poseben objekt, ki opiše napako ali nepričakovano vedenje skripte. Uporabljamo jih, ko želimo izvajanje kode varno zaustaviti ali preusmeriti, če naletimo na težavo, ki je program ne more samodejno obdelati. S stavkom throw izjemo sprožimo, s strukturo try...catch pa jo ulovimo in pravočasno rešimo pred sesutjem celotne spletne strani.

PRIMER

[file:Neulovljena izjema]
<?php
 // Primer izjeme, ki ni ujeta - sproži usodno napako
 function preveriDeljenje($stevilka, $delitelj) {
 if ($delitelj == 0) {
 throw new Exception("Deljenje z ničlo ni mogoče.");
 }
 return $stevilka / $delitelj;
 }

echo preveriDeljenje(10, 0);
?>

[file:Osnovni try-catch]
<?php
 // Z uporabo try...catch ulovimo napako in nadaljujemo
 function varnoDeljenje($stevilka, $delitelj) {
 if ($delitelj == 0) {
 throw new Exception("Deljenje z ničlo!");
 }
 return $stevilka / $delitelj;
 }
 
 try {
 echo varnoDeljenje(10, 0);
 } catch (Exception $e) {
 echo "Napaka ulovljena: " . $e->getMessage();
 }
?>

[file:Exception()]
<?php
 // Konstruktor Exception omogoča nastavitev sporočila in kode
 try {
 throw new Exception("Opis napake", 404);
 } catch (Exception $e) {
 echo "Sporočilo: " . $e->getMessage() . " ";
 echo "Koda: " . $e->getCode();
 }
?>

[file:getCode()]
<?php
 // getCode() vrne številčno kodo napake
 try {
 throw new Exception("Stran ni bila najdena", 404);
 } catch (Exception $e) {
 echo "Identifikacija napake (Koda): " . $e->getCode();
 }
?>

[file:getFile()]
<?php
 try {
 throw new Exception("Napaka v kodi!");
 } catch (Exception $e) {
 $imeDatoteke = str_contains($e->getFile(), "eval") ? "index.php" : basename($e->getFile());
 echo "Datoteka: " . $imeDatoteke;
 }
?>

[file:getLine()]
<?php
 // getLine() vrne številko vrstice
 try {
 throw new Exception("Napačen vnos!");
 } catch (Exception $e) {
 echo "Napaka se je zgodila v vrstici: " . $e->getLine();
 }
?>

[file:getMessage()]
<?php
 // getMessage() vrne opis napake
 try {
 throw new Exception("Uporabnik ne obstaja.");
 } catch (Exception $e) {
 echo "Opis izjeme: " . $e->getMessage();
 }
?>

[file:getPrevious()]
<?php
 // getPrevious() nam pomaga pri veriženju izjem
 try {
 try {
 throw new Exception("Prvotna napaka", 1);
 } catch (Exception $prva) {
 throw new Exception("Sekundarna napaka", 2, $prva);
 }
 } catch (Exception $druga) {
 echo "Trenutna: " . $druga->getMessage() . " ";
 if ($prejsnja = $druga->getPrevious()) {
 echo "Izvorna napaka: " . $prejsnja->getMessage();
 }
 }
?>

[file:getTrace()]
<?php
 function testnaFunkcija() {
 throw new Exception("Sledimo klicu!");
 }

try {
 testnaFunkcija();
 } catch (Exception $napaka) {
 echo "Sled sklada (Array): ";
 $sled = $napaka->getTrace();
 foreach ($sled as &$korak) {
 if (isset($korak["file"])) {
 $korak["file"] = basename($korak["file"]);
 }
 }
 print_r($sled); echo " ";
 }
?>

[file:getTraceAsString()]
<?php
 function testNiza() {
 throw new Exception("Sled v nizu!");
 }

try {
 testNiza();
 } catch (Exception $napaka) {
 $nizSledi = $napaka->getTraceAsString();
 
 echo "Sled v nizu: ";
 
 $deli = explode(":", $nizSledi);
 if (count($deli) > 2) {
 echo "#0 " . end($deli);
 } else {
 echo $nizSledi;
 }
 }
?>

[file:try-catch-finally]
<?php
 // finally blok se izvede v vsakem primeru
 try {
 echo "Poskus zagona... ";
 throw new Exception("Nekaj ni v redu.");
 } catch (Exception $e) {
 echo "Napaka: " . $e->getMessage() . " ";
 } finally {
 echo "Postopek zaključen.";
 }
?>

REZULTAT

Tu bo prikazan rezultat...

Vgrajene metode objekta Exception

Ko izjemo ulovimo znotraj catch bloka, dobimo dostop do objekta, ki vsebuje natančne podatke o tem, kje in zakaj je šlo nekaj narobe. Za pridobivanje teh podatkov uporabljamo naslednje metode:

Exception(): Konstruktor za ustvarjanje novega objekta izjeme (uporabimo pri throw new Exception("Sporočilo")).
getMessage(): Vrne opisno sporočilo o napaki, ki smo ga določili ob sprožitvi.
getCode(): Vrne številčno kodo napake za lažjo identifikacijo ali kategorizacijo težav.
getFile(): Vrne polno (absolutno) pot do datoteke, v kateri je prišlo do izjeme.
getLine(): Vrne točno številko vrstice, ki je sprožila izjemo.
getTrace(): Vrne podrobno tabelo (array) vseh klicev funkcij in datotek, ki so pripeljale do trenutka napake.
try ... catch ... finally: Glavna struktura za obdelavo izjem. Blok finally se izvede vedno (ne glede na to, ali je prišlo do napake ali ne), kar je idealno za npr. zapiranje odprtih datotek ali povezav z bazo.

💡 Kdaj uporabiti izjeme v praksi?

Izjeme niso namenjene običajnim sintaktičnim napakam (kot je pozabljeno podpičje). Uporabljamo jih za reševanje zunanjih, nepredvidljivih situacij, na katere programer nima neposrednega vpliva – na primer: ko oddaljeni API strežnik ne vrne podatkov, ko uporabnik naloži napačen tip datoteke ali ko se zruši povezava s podatkovno bazo. S tem, ko napako ulovite, lahko uporabniku prikažete prijazno obvestilo, namesto rdeče sistemske napake.

PHP Izjeme (Exceptions)

Vgrajene metode objekta Exception

💡 Kdaj uporabiti izjeme v praksi?

Vadnica.org

Povezave

Podpora