PHP -uitzonderingen
Wat is een uitzondering?
Een uitzondering is een object dat een fout of onverwacht gedrag van een PHP-script beschrijft.
Uitzonderingen worden veroorzaakt door veel PHP-functies en klassen.
Door de gebruiker gedefinieerde functies en klassen kunnen ook uitzonderingen genereren.
Uitzonderingen zijn een goede manier om een functie te stoppen wanneer deze gegevens tegenkomt die niet kunnen worden gebruikt.
Een uitzondering maken
Met de throw
instructie kan een door de gebruiker gedefinieerde functie of methode een uitzondering genereren. Wanneer een uitzondering wordt gegenereerd, wordt de code die erop volgt niet uitgevoerd.
Als een uitzondering niet wordt opgevangen, treedt er een fatale fout op met het bericht "Ongevangen uitzondering".
Laten we proberen een uitzondering te maken zonder deze te vangen:
Voorbeeld
<?php
function divide($dividend, $divisor) {
if($divisor == 0)
{
throw new Exception("Division by zero");
}
return $dividend / $divisor;
}
echo divide(5, 0);
?>
Het resultaat ziet er ongeveer zo uit:
Fatal error: Uncaught Exception: Division by zero in
C:\webfolder\test.php:4
Stack trace: #0 C:\webfolder\test.php(9):
divide(5, 0) #1 {main} thrown in C:\webfolder\test.php on line 4
De try...catch-verklaring
Om de fout uit het bovenstaande voorbeeld te voorkomen, kunnen we de
try...catch
instructie gebruiken om uitzonderingen op te vangen en het proces voort te zetten.
Syntaxis
try {
code that can throw exceptions
} catch(Exception $e) {
code that runs when an exception is caught
}
Voorbeeld
Een bericht weergeven wanneer een uitzondering wordt gegenereerd:
<?php
function divide($dividend, $divisor) {
if($divisor ==
0) {
throw new Exception("Division by zero");
}
return $dividend / $divisor;
}
try {
echo
divide(5, 0);
} catch(Exception $e) {
echo "Unable to divide.";
}
?>
Het catch-blok geeft aan welk type uitzondering moet worden opgevangen en de naam van de variabele die kan worden gebruikt om toegang te krijgen tot de uitzondering. In het bovenstaande voorbeeld is het type uitzondering Exception
en is de variabelenaam $e
.
De try...catch... eindelijk Statement
De try...catch...finally
verklaring kan worden gebruikt om uitzonderingen op te vangen. Code in het
finally
blok wordt altijd uitgevoerd, ongeacht of er een uitzondering is opgevangen. Indien
finally
aanwezig, is het catch
blok optioneel.
Syntaxis
try {
code that can throw exceptions
} catch(Exception $e) {
code that runs when an exception is caught
} finally {
code that
always runs regardless of whether an exception was caught
}
Voorbeeld
Toon een bericht wanneer een uitzondering wordt gegenereerd en geef vervolgens aan dat het proces is beëindigd:
<?php
function divide($dividend, $divisor) {
if($divisor
== 0) {
throw new Exception("Division by zero");
}
return $dividend / $divisor;
}
try {
echo
divide(5, 0);
} catch(Exception $e) {
echo "Unable to
divide. ";
} finally {
echo "Process complete.";
}
?>
Voorbeeld
Voer een tekenreeks uit, zelfs als een uitzondering niet is opgevangen:
<?php
function divide($dividend, $divisor) {
if($divisor == 0)
{
throw new Exception("Division by zero");
}
return $dividend / $divisor;
}
try {
echo divide(5, 0);
} finally {
echo
"Process complete.";
}
?>
Het uitzonderingsobject
Het uitzonderingsobject bevat informatie over de fout of het onverwachte gedrag dat de functie heeft aangetroffen.
Syntaxis
new Exception(message, code, previous)
Parameterwaarden
Parameter | Description |
---|---|
message | Optional. A string describing why the exception was thrown |
code | Optional. An integer that can be used used to easily distinguish this exception from others of the same type |
previous | Optional. If this exception was thrown in a catch block of another exception, it is recommended to pass that exception into this parameter |
Methoden:
Bij het opvangen van een uitzondering toont de volgende tabel enkele van de methoden die kunnen worden gebruikt om informatie over de uitzondering te krijgen:
Method | Description |
---|---|
getMessage() | Returns a string describing why the exception was thrown |
getPrevious() | If this exception was triggered by another one, this method returns the previous exception. If not, then it returns null |
getCode() | Returns the exception code |
getFile() | Returns the full path of the file in which the exception was thrown |
getLine() | Returns the line number of the line of code which threw the exception |
Voorbeeld
Voer informatie uit over een uitzonde ring die is gegenereerd:
<?php
function divide($dividend, $divisor) {
if($divisor == 0)
{
throw new Exception("Division by zero", 1);
}
return $dividend / $divisor;
}
try {
echo
divide(5, 0);
} catch(Exception $ex) {
$code = $ex->getCode();
$message = $ex->getMessage();
$file = $ex->getFile();
$line = $ex->getLine();
echo "Exception thrown in $file on line
$line: [Code $code]
$message";
}
?>
Volledige uitzonderingsreferentie
Ga voor een volledige referentie naar onze Complete PHP Exception Reference .
De referentie bevat beschrijvingen en voorbeelden van alle Exception-methoden.