PHP Izjeme (Exceptions)

Izjema je objekt, ki opiše napako ali nepričakovano vedenje skripte. Uporabljamo jih, ko želimo funkcijo varno zaustaviti, če naleti na podatek, ki ga ne more obdelati. S stavkom throw izjemo sprožimo, s stavki try...catch pa jo ulovimo in preprečimo sesutje programa.

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() . "\n";
    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() . "\n";
    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):\n";
    $sled = $napaka->getTrace();
    foreach ($sled as &$korak) {
      if (isset($korak["file"])) {
        $korak["file"] = basename($korak["file"]);
      }
    }
    print_r($sled);
  }
?>

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

try {
    testNiza();
  } catch (Exception $napaka) {
    $nizSledi = $napaka->getTraceAsString();
    
    echo "Sled v nizu:\n";
    
    $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...\n";
    throw new Exception("Nekaj ni v redu.");
  } catch (Exception $e) {
    echo "Napaka: " . $e->getMessage() . "\n";
  } finally {
    echo "Postopek zaključen.";
  }
?>

REZULTAT

Tu bo prikazan rezultat...

Exception(): Konstruktor za ustvarjanje novega objekta izjeme.
getMessage(): Vrne opisno sporočilo o napaki.
getCode(): Vrne številčno kodo napake za lažjo identifikacijo.
getFile(): Vrne absolutno pot do datoteke, kjer je prišlo do izjeme.
getLine(): Vrne številko vrstice, ki je sprožila izjemo.
getTrace(): Vrne podrobno tabelo (array) vseh klicev funkcij do trenutka napake.
try ... catch ... finally: Glavna struktura za obdelavo izjem. Blok finally se izvede vedno, kar je idealno za npr. zapiranje povezav z bazo.