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 :
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 4Dans 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.
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 22Pour 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
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 exceptionIV-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.
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é :
/**
* @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 :
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
....
...