PHP Exception Handling

Des exceptions sont utilisées pour modifier l'écoulement normal d'un script si une erreur se produit spécifié.

---

Qu'est-ce qu'un Exception

Avec PHP 5 est venu d'une manière orientée objet nouveau de traiter les erreurs.

La gestion des exceptions est utilisée pour changer le flux normal de l'exécution de code si une erreur spécifié (exceptionnelle) survient. Cette condition est appelée une exception. C'est ce qui arrive normalement quand une exception est déclenchée:

• Le code d'état en cours est enregistrée
• L'exécution de code passe à un modèle prédéfini (personnalisé) la fonction gestionnaire d'exception
• Selon la situation, le gestionnaire peut alors reprendre l'exécution de l'état du code sauvé, mettre fin à l'exécution du script ou de continuer le script à partir d'un autre emplacement dans le code

Nous allons montrer les différentes méthodes de gestion des erreurs:

• L'utilisation de base des exceptions
• Création d'un gestionnaire d'exception personnalisée
• Exceptions multiples
• Re-levée d'une exception
• Définition d'un gestionnaire de haut niveau exception

Remarque: Les exceptions ne doivent être utilisés avec des conditions d'erreur, et ne doit pas être utilisée pour sauter à un autre endroit dans le code en un point spécifié.

---

Utilisation de base des exceptions

Quand une exception est levée, le code suivant ne sera pas exécuté et PHP tentera de trouver la correspondance "catch" bloc.

Si une exception n'est pas attrapé, une erreur fatale sera émise avec une "Exception non rattrapée" message.

Essayons de lever une exception sans l'attraper:

<?php
//create function with an exception
function checkNum($number)
  {
  if($number>1)
    {
    throw new Exception("Value must be 1 or below");
    }
  return true;
  }

//trigger exception
checkNum(2);
?>

Le code ci-dessus obtiendrez une erreur comme ceci:

Fatal error: Uncaught exception 'Exception'
with message 'Value must be 1 or below' in C:\webfolder\test.php:6
Stack trace: #0 C:\webfolder\test.php(12):
checkNum(28) #1 {main} thrown in C:\webfolder\test.php on line 6

Essayez, lancer et attraper

Pour éviter l'erreur de l'exemple ci-dessus, nous avons besoin pour créer le code approprié pour gérer une exception.

Code d'exception appropriée doit inclure:

1. Essayez - Une fonction utilisant une exception devrait être dans un "try" bloc. Si l'exception ne se déclenche pas, le code continuera comme d'habitude. Toutefois, si l'exception se déclenche, une exception est «jeté»
2. Jetez - Voilà comment vous déclenchez une exception. Chaque "lancer" doit avoir au moins un «catch»
3. Catch - Un "capture" bloc récupère une exception et crée un objet contenant les informations d'exception

Essayons de déclencher une exception avec un code valide:

<?php
//create function with an exception
function checkNum($number)
  {
  if($number>1)
    {
    throw new Exception("Value must be 1 or below");
    }
  return true;
  }

//trigger exception in a "try" block
try
  {
  checkNum(2);
  //If the exception is thrown, this text will not be shown
  echo 'If you see this, the number is 1 or below';
  }

//catch exception
catch(Exception $e)
  {
  echo 'Message: ' .$e->getMessage();
  }
?>

Le code ci-dessus obtiendrez une erreur comme ceci:

Message: Value must be 1 or below

Exemple expliqué:

Le code ci-dessus jette une exception et qu'il attrape:

1. Le checkNum () est créée. Il vérifie si un nombre est supérieur à 1. Si c'est le cas, une exception est levée
2. Le checkNum () est appelée dans un "try" bloc
3. L'exception au sein de la fonction checkNum () est lancée
4. Le "catch" bloc retrives l'exception et crée un objet ($ e) contenant les informations d'exception
5. Le message d'erreur de l'exception est fait l'écho en appelant $ e-> getMessage () de l'objet exception

Toutefois, une façon de contourner la "chaque lancer doit y avoir un cran" règle est de définir un gestionnaire de haut niveau exception pour gérer les erreurs qui se glisseraient à travers.

---

Création d'une classe d'exception personnalisée

Création d'un gestionnaire d'exception personnalisé est assez simple. Nous créons simplement une classe spéciale avec des fonctions qui peuvent être appelées si une exception survient en PHP. La classe doit être une extension de la classe d'exception.

La classe d'exception personnalisée hérite des propriétés de la classe des exceptions de PHP et vous pouvez ajouter des fonctions personnalisées.

Permet de créer une classe d'exception:

<?php
class customException extends Exception
  {
  public function errorMessage()
    {
    //error message
    $errorMsg = 'Error on line '.$this->getLine().' in '.$this->getFile()
    .': <b>'.$this->getMessage().'</b> is not a valid E-Mail address';
    return $errorMsg;
    }
  }

$email = "someone@example...com";

try
  {
  //check if
  if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE)
    {
    //throw exception if email is not valid
    throw new customException($email);
    }
  }

catch (customException $e)
  {
  //display custom message
  echo $e->errorMessage();
  }
?>

La nouvelle classe est une copie de la classe d'exception ancienne, avec un ajout de la fonction errorMessage (). Comme il s'agit d'une copie de l'ancienne classe, et il hérite des propriétés et méthodes de la vieille classe, nous pouvons utiliser les méthodes de la classe d'exception comme getline () et getFile () et getMessage ().

Exemple expliqué:

Le code ci-dessus jette une exception et l'attrape avec une classe d'exception personnalisée:

1. La classe customException () est créée comme une extension de la classe d'exception ancienne. De cette façon, il hérite de toutes les méthodes et les propriétés de la classe d'exception ancienne
2. La fonction errorMessage () est créée. Cette fonction retourne un message d'erreur si une adresse e-mail n'est pas valide
3. La variable $ email est défini sur une chaîne qui n'est pas une adresse e-mail
4. Le "try" bloc est exécuté et une exception est levée depuis l'adresse e-mail n'est pas valide
5. Le "catch" bloc intercepte l'exception et affiche le message d'erreur

---

Exceptions multiples

Il est possible pour un script pour utiliser plusieurs exceptions à vérifier plusieurs conditions.

Il est possible d'utiliser plusieurs blocs else .. si, un commutateur, ou des exceptions imbriquer plusieurs. Ces exceptions peuvent utiliser des classes d'exception différents et retourner les messages d'erreur différents:

<?php
class customException extends Exception
{
public function errorMessage()
{
//error message
$errorMsg = 'Error on line '.$this->getLine().' in '.$this->getFile()
.': <b>'.$this->getMessage().'</b> is not a valid E-Mail address';
return $errorMsg;
}
}

$email = "someone@example.com";

try
  {
  //check if
  if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE)
    {
    //throw exception if email is not valid
    throw new customException($email);
    }
  //check for "example" in mail address
  if(strpos($email, "example") !== FALSE)
    {
    throw new Exception("$email is an example e-mail");
    }
  }

catch (customException $e)
  {
  echo $e->errorMessage();
  }

catch(Exception $e)
  {
  echo $e->getMessage();
  }
?>

Exemple expliqué:

Le code ci-dessus les tests deux conditions et lève une exception si l'une des conditions ne sont pas remplies:

1. La classe customException () est créée comme une extension de la classe d'exception ancienne. De cette façon, il hérite de toutes les méthodes et les propriétés de la classe d'exception ancienne
2. La fonction errorMessage () est créée. Cette fonction retourne un message d'erreur si une adresse e-mail n'est pas valide
3. La variable $ email est défini sur une chaîne qui est une adresse e-mail, mais contient la chaîne "par exemple"
4. Le "try" bloc est exécuté et une exception n'est pas levée sur la première condition
5. La deuxième condition déclenche une exception, car l'e-mail contient la chaîne "par exemple"
6. Le "catch" bloc intercepte l'exception et affiche le message d'erreur correct

Si l'exception renvoyée étaient de la classe et customException n'y avait pas de prise customException, seulement les captures d'exception de base, à l'exception seraient traitées là-bas.

---

Re-levée des exceptions

Parfois, quand une exception est levée, vous pouvez le manipuler différemment de la façon standard. Il est possible de lever une exception une seconde fois dans un "catch" bloc.

Un script devrait masquer les erreurs du système auprès des utilisateurs. Les erreurs système peuvent être importants pour le codeur, mais n'est d'aucun intérêt pour l'utilisateur. Pour rendre les choses plus facile pour l'utilisateur que vous pouvez re-lever l'exception avec un message convivial:

<?php
class customException extends Exception
  {
  public function errorMessage()
    {
    //error message
    $errorMsg = $this->getMessage().' is not a valid E-Mail address.';
    return $errorMsg;
    }
  }

$email = "someone@example.com";

try
  {
  try
    {
    //check for "example" in mail address
    if(strpos($email, "example") !== FALSE)
      {
      //throw exception if email is not valid
      throw new Exception($email);
      }
    }
  catch(Exception $e)
    {
    //re-throw exception
    throw new customException($email);
    }
  }

catch (customException $e)
  {
  //display custom message
  echo $e->errorMessage();
  }
?>

Exemple expliqué:

Le code ci-dessus teste si l'adresse email contient la chaîne "par exemple" en elle, si c'est le cas, l'exception est relancée:

1. La classe customException () est créée comme une extension de la classe d'exception ancienne. De cette façon, il hérite de toutes les méthodes et les propriétés de la classe d'exception ancienne
2. La fonction errorMessage () est créée. Cette fonction retourne un message d'erreur si une adresse e-mail n'est pas valide
3. La variable $ email est défini sur une chaîne qui est une adresse e-mail, mais contient la chaîne "par exemple"
4. Le "essayer" bloc contient un autre "essai" bloc pour le rendre possible de re-lever l'exception
5. La seule exception est déclenchée depuis l'e-mail contient la chaîne "par exemple"
6. Le "catch" bloc intercepte l'exception et re-jette un "customException"
7. Le "customException" est pris et affiche un message d'erreur

Si l'exception n'est pas attrapée dans sa forme actuelle "try" bloc, il va rechercher un bloc catch sur "niveaux supérieurs".

---

Définir un gestionnaire de premier niveau Exception

Le set_exception_handler () la fonction définit une fonction définie par l'utilisateur à gérer toutes les exceptions non interceptées.

<?php
function myException($exception)
{
echo "<b>Exception:</b> " , $exception->getMessage();
}

set_exception_handler('myException');

throw new Exception('Uncaught Exception occurred');
?>

La sortie du code ci-dessus doit être quelque chose comme ceci:

Exception: Uncaught Exception occurred

Dans le code ci-dessus il n'y avait pas "de capture" bloc. Au lieu de cela, le gestionnaire de haut niveau exception déclenchée. Cette fonction doit être utilisée pour intercepter des exceptions non interceptées.

---

Règles pour les exceptions

• Code peut être entouré dans un bloc try, pour aider à intercepter les exceptions possibles
• Chaque bloc try ou «jeter» doit avoir au moins un bloc catch correspondant
• Plusieurs blocs catch peuvent être utilisés pour attraper différentes classes d'exceptions
• Des exceptions peuvent être lancées (ou relancées) dans un bloc catch au sein d'un bloc try

Une règle simple: Si vous jetez quelque chose, vous devez l'attraper.