Developpez.com

Club des développeurs et IT pro
Plus de 4 millions de visiteurs uniques par mois

Exceptions et PHP5


précédentsommairesuivant

IV. Amélioration du système d'exception

IV-A. Capture automatique des exceptions

La présence de la gestion des exceptions dans certaines extensions de PHP, généralement non utilisée car non connue des développeurs, ainsi que les possibles risques d'avoir un throw égaré dans les profondeurs d'une classe impliquent que certaines exceptions soulevées peuvent ne pas être attrapées. Nous obtenons alors un message peu agréable de la sorte :

 
Sélectionnez

Fatal error: Uncaught exception 'Exception' with message 'Message non capturé' 
in C:\wamp\www\exception\index.php:4 
Stack trace: #0 C:\wamp\www\exception\index.php(7): showUncaughtException() #1 {main} 
thrown in C:\wamp\www\exception\index.php on line 4

Dans le cas de PDO par exemple, une exception non gérée affiche toute la chaîne de connexion incluant les données de connexion à la base de données.

 
Sélectionnez

Exception de connexion à la BDD avec PDO a écrit :
Fatal error: Uncaught exception 'PDOException' with message 'SQLSTATE[42000] [1049] 
Unknown database 'jeu_de_role'' in 
c:\program files\apache group\www\dvp\tests\pdo.php:22 
Stack trace: #0 c:\program files\apache group\www\dvp\tests\pdo.php(22): 
PDO->__construct('mysql:host=loca...', 'root', '1234', Array) #1 {main} 
thrown in c:\program files\apache group\www\dvp\tests\pdo.php on line 22

Pour remédier à ce problème évident, PHP définit la fonction set_exception_handler permettant de définir une fonction de callback appelée à chaque exception soulevée et non capturée

Exemple d'utilisation de la fonction set_exception_handler
Sélectionnez

function exception_handler($myException)
{
    echo 'Exception non capturée : '.$myException->getMessage();
}
 
set_exception_handler('exception_handler');
 
throw new Exception('voici une exception');
// Affichera l'exception non capturé : voici une exception

IV-B. Bascule erreur->exception

Comme nous l'avons vu précédemment, PHP5 n'utilise pas les exceptions, il se contente de les proposer au développeur. Parallèlement, PHP permet de redéfinir le support des erreurs système. Merveilleux, nous avons tout pour faire notre propre gestion des erreurs en utilisant les exceptions.

Exemple de redéfintion de la gestion d'erreur
Sélectionnez

function exception_handler($code, $msg, $file, $line)
{
    throw new Exception($msg, $code);
}
 
set_error_handler('exception_handler');
 
try
{
    fopen();
}
catch (Exception $myException)
{
    echo '<div style="color:red">'.$myException->getMessage().'</div>';
}

Cet exemple est trop simple pour être utilisable tel quel. Il retire beaucoup d'informations par rapport à ce qu'apporterait une erreur. Pour l'étendre, nous pouvons d'une part créer une classe fille MyPHPException, chargée de ne traiter que ce type d'erreur et nous laissant libre d'étendre nos exceptions ailleurs, d'autre part, nous pouvons ajouter les informations de l'erreur dans l'exception. Par exemple, nous pouvons obtenir la ligne et le fichier dans lequel s'est produite l'erreur, ainsi que le contexte à ce stade du script. Nous pouvons ajouter aussi des informations apportées par l'exception. En effet, nous avons aussi accès au contexte lors de la levée d'exception. Ainsi, nous pouvons connaître la dernière fonction appelée, dans laquelle s'est déroulée l'erreur. Nous avons aussi accès aux tableau super globaux et aux variables locales.

Voici notre nouveau script amélioré :

Gestion complète des erreurs par les exceptions
Sélectionnez

/**
* @desc Notre classe d'exception pour les erreurs PHP
*/
class MyPHPException extends Exception
{
    /**
    * @desc Constructeur
    */
    public function __construct($msg, $code, $file, $line, $context)
    {
        $this->message = $msg;
        $this->code = $code;
        $this->line = $line;
        $this->file = $file;
        $this->context = $context;
 
        parent::__construct($msg, $code);
    }
 
    /**
    * @desc Affichage de l'erreur
    */
    public function showError()
    {
        echo 'PHP a généré l\'erreur système suivante : ['.$this->code.' | '.
            $this->getMessage().'] à la ligne '.
            $this->line.' du fichier '.$this->file;
 
        // $Mytrace contient le contexte de l'exception
        // $this->context contient le contexte de l'erreur
 
        $Mytrace = $this->getTrace();
        //print_r($Mytrace);
        if ( ! empty($Mytrace['1']['function'] ))
        {
            echo ' sur la fonction '.$Mytrace['1']['function'];
        }     
        echo '<br /><br/>Contexte lors de l\'erreur :<br/><pre>';
        print_r($this->context);
        echo '</pre>';
    }
}
 
/**
* @desc la fonction de callback, chargée de lancer l'exception
*/
function errorToException($code, $msg, $file, $line, $context)
{
    throw new MyPHPException($msg, $code, $file, $line, $context);
}
 
// redéfinition de la gestion d'erreur
set_error_handler('errorToException');
 
// Enfin, notre script
try
{
    fopen();
}
catch (MyPHPException $myPHPException)
{
    echo '<div style="color:red">'.$myPHPException->showError().'</div>';
}

Ceci nous affichera à l'écran :

 
Sélectionnez

PHP a généré l'erreur système suivante : [2 | fopen() expects at least 2 parameters, 0 given] 
à la ligne 44 du fichier .C:\wamp\www\exceptions\index.php sur la fonction fopen
 
Contexte lors de l'erreur :
 
Array
(
    [GLOBALS] => Array
 *RECURSION*
    [_ENV] => Array
        (
            [ALLUSERSPROFILE] => C:\Documents and Settings\All Users
            [CommonProgramFiles] => C:\Program Files\Fichiers communs
            [ComSpec] => C:\WINDOWS\system32\cmd.exe
            [FP_NO_HOST_CHECK] => NO
            [NUMBER_OF_PROCESSORS] => 1
            [OS] => Windows_NT
            ....
            ...

précédentsommairesuivant

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

  

Copyright © 13/09/2006 Guillaume Affringue. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.