Comme tous les langages de programmation, PHP est susceptible de générer, d'afficher et de traiter des erreurs. Le terme étant à dénotation intrinsèquement négative, on a forcément tendance à vouloir les éviter à tout prix, à obtenir une exécution sans aucun message d'erreur, quitte à les ignorer, ce qui revient à entasser la poussière sous le tapis du salon lorsqu'on fait le ménage... En réalité il vaudrait sans doute mieux considérer les mécanismes d'erreurs comme des aides à la programmation. Certes c'est toujours désagréable de récolter une série de messages d'erreurs lorsqu'on vient de finir de coder l'application qui révolutionnera l'avenir de l'internet ! Mais les erreurs PHP permettent de corriger les défauts de l'application, d'améliorer son style de programmation, et de gérer les impondérables qui surviendront lorsque des utilisateurs réels expérimenteront l'application.

Quels sont donc les enjeux d'une politique de gestion des erreurs ? Tout d'abord et évidemment, il faudra utiliser intelligemment ces erreurs en phase de développement et surtout de tests. Ensuite, il faudra prendre garde à ce que ces messages d'erreurs ne viennent pas défigurer une charte graphique soignée lorsqu'on mettra l'application en production : on prendra alors soin de masquer les erreurs aux visiteurs, tout en gardant la possibilité d'en être averti (phase de maintenance de l'application).

En programmation, une erreur est définie comme un comportement anormal de l'application. En PHP on les distingue des exceptions, qui sont des comportements exceptionnels, mais cependant normaux. Dans certains cas, vous serez amenés à vous demander si c'est une erreur que vous devez définir, ou une exception. Tout est une question de sémantique, mais aussi d'outils associés. Le comportement de PHP n'est pas le même face à une erreur et face à une exception (et les deux sont configurables). La gestion des exceptions en PHP5 est décrite dans  cet article.

Dans un langage de programmation compilé, comme le C, on distingue les erreurs de compilation des erreurs d'exécution. Les erreurs de compilation sont celles qui peuvent être anticipées par la machine dès l'écriture du code, et qui empêchent la génération du langage machine. Ce sont les plus facile à corriger puisque le compilateur (le préprocesseur, l'analyseur syntaxique, l'éditeur de liens...) donne une liste de ces erreurs à chaque tentative de compilation. Les erreurs d'exécution sont plus sournoises, ce sont ces "segmentation faults" qui n'apparaissent que lorsque le programme (mal testé ?) est en production et que l'utilisateur entre des valeurs bizarres dans la machine. PHP, lui, est un langage interprété, donc cette distinction n'existe pas vraiment : toutes les erreurs apparaîtront dans la phase d'interprétation du script. Néanmoins il reste certaines similitudes. Par exemple dans un compilateur comme dans un interpréteur, il y a un analyseur syntaxique qui va vérifier que votre programme est bien conforme à la grammaire formelle du langage (c'est-à-dire que vous avez respecté la syntaxe, que vous n'avez pas oublié un point-virgule dans un coin, ce genre de choses). Les erreurs rencontrées par cette analyseur syntaxique sont les "parse errors" (erreurs d'analyse), les erreurs que vous verrez sans doute apparaître en premier puisqu'elles empêchent l'interprétation du reste du script.

En fait toutes les erreurs PHP sont réparties en catégories, soit par nature, soit par gravité de l'erreur (gravité qui peut être subjective ou dépendante de l'application, d'ailleurs). Voici un petit tableau récapitulatif :

Le codage bit à bit de tous les codes d'erreurs, qui ne choquera On remarquera en particulier que la valeur E_ALL ne couvre pas les erreurs E_STRICT.

Niveaux d'erreur, informations associées (message, script, numéro de ligne)

Valeurs de retour à NULL ou FALSE, or, or die (à éviter)

configuration du niveau d'erreur (php.ini et en ligne) php.ini : error_reporting = ... un mot sur E_ALL et E_STRICT

Avec trigger_error E_USER_NOTICE E_USER_WARNING E_USER_ERROR

Désactivation des erreurs avec @, à éviter php.ini : display_errors = Off

php.ini : log_errors = On, error_log = fichier Attention à la journalisation vue comme une poubellisation ignore_repeated_errors error_log = syslog : journalisation système (sur un système dédié) log manuel avec error_log($message) envoi par mail avec error_log($message, 1, $email, $headers); titre du message non modifiable car header Subject déjà existant utile en cas d'intrusion car intouchable une fois qu'envoyé

remote_debugging dans le php.ini, error_log avec deuxième paramètre à 2 serveur dédié au débuggage

que fait track_errors dans le php.ini ? Affichage personnalisé avec error_prepend_string et error_append_string

PHP ne s'occupe plus de rien. Ni journalisation, ni filtrage par error_reporting ou @, ni arrêt du script après E_USER_ERROR -> appeler exit au besoin callback = fonction de rappel méthode : tableau à la place d'une chaîne de caractères set_error_handler, restore_error_handler ne concerne pas E_ERROR et E_PARSE, entre autres

Digression sur les assertions Aide à la sûreté de fonctionnement A désactiver en production ?

Niveau d'erreur au minimum, ne jamais masquer les erreurs, Tout montrer pour faciliter le débogage. Outil pour amener l'application à un état de bon fonctionnement importance des jeux de tests Importance des notice (exemple des indices de tableau associatif)

Ne jamais afficher le détail des erreurs (raisons de sécurité), enrober l'erreur au niveau interface, logger, avertir qqn en cas de souci (niveau d'erreur significatif : moins de ressources en production qu'en développement). error reporting personnalisé utilisateurs/administrateurs ? Les erreurs permettent de détecter les problèmes transitoires et les tentatives d'attaques.

Système permettant de switcher entre une configuration de développement et une configuration de production.

Je tiens à remercier Yogui pour sa très grande patience.

L'excellent article de Guillaume Affringue sur  Exceptions et PHP5

PHP 5 avancé, pages de doc http://fr.php.net/manual/fr/ref.errorfunc.php