Etendre les Exceptions

Une classe d'exception définie par l'utilisateur peut être définie en étendant la classe Exception intégrée. Les membres et les propriétés ci-dessous montrent ce qui est accessible dans la classe enfant qui dérive de la classe Exception intégrée.

Exemple #1 La classe d'exception intégrée

<?php
class Exception implements Throwable
{
protected
$message = 'Unknown exception'; // Message d'exception
private $string; // cache de __toString
protected $code = 0; // code d'exception défini par l'utilisateur
protected $file; // nom de fichier source de l'exception
protected $line; // ligne source de l'exception
private $trace; // trace de la pile d'exécution
private $previous; // exception précédente si exception imbriquée

public function __construct($message = '', $code = 0, Throwable $previous = null);

final private function
__clone(); // Inhibe la duplication des exceptions.

final public function getMessage(); // message de l'exception
final public function getCode(); // code de l'exception
final public function getFile(); // nom du fichier source
final public function getLine(); // ligne source
final public function getTrace(); // tableau de la trace de la pile d'exécution
final public function getPrevious(); // l'exception précédente
final public function getTraceAsString(); // trace sous forme de chaine de caractères

Si une classe étend la classe Exception intégrée et redéfinit le constructeur, il est fortement recommandé qu'elle appelle également parent::__construct() pour s'assurer que toutes les données disponibles ont été correctement assignées. La méthode __toString() peut être redéfinie pour fournir une sortie personnalisée lorsque l'objet est présenté sous forme de chaîne de caractères.

Note:

Les exceptions ne peuvent pas être clonées. Tenter de cloner une Exception entraînera une erreur fatale E_ERROR.

Exemple #2 Étendre la classe Exception

<?php

class MyException extends Exception
{
// Redéfini l'exception pour que le message ne soit pas facultatif.
public function __construct($message, $code = 0, Throwable $previous = null) {
// du code

To Top