Les erreurs de diagnostic

Les erreurs de diagnostic, aussi appelées erreurs traditionnelles, servent à signaler un certain nombre de conditions différentes, et peuvent être affichées et/ou enregistrées dans un journal selon les besoins. Par défaut, PHP signale tous les diagnostics. (Antérieurement à PHP 8.0.0, les diagnostics E_NOTICE et E_DEPRECATED n'étaient pas signalés par défaut.)

Contrairement aux erreurs Throwable, la plupart des erreurs de diagnostic n'interrompent pas le flux normal d'exécution. Les diagnostics fatals, tels que E_ERROR, terminent le script.

Les diagnostics qui sont signalés et ceux qui sont ignorés sont contrôlés par la directive php.ini error_reporting, ou lors de l'exécution du script en appelant error_reporting(). Il est fortement recommandé de configurer la directive, car certaines erreurs peuvent se produire avant que l'exécution du script ne commence.

Note:

Dans un environnement de développement, la directive error_reporting devrait toujours être configurée avec E_ALL, afin d'être informé et de corriger les problèmes relevés par PHP. En production, le niveau de verbosité peut être réduit à E_ALL & ~E_NOTICE & ~E_DEPRECATED, mais dans de nombreux cas E_ALL reste approprié, car il peut avertir en avance de problèmes potentiels.

Ce qu'il advient des diagnostics dépend de deux autres directives php.ini. display_errors détermine si le diagnostic est affiché dans la sortie du script. Ceci devrait toujours être désactivé dans un environnement de production, car la sortie peut contenir des informations confidentielles, telles que les mots de passe de base de données. Il est cependant souvent utile de l'activer lors du développement, car cela assure un signalement immédiat des problèmes.

En plus d'afficher les erreurs, PHP peut enregistrer les diagnostics lorsque la directive log_errors est activée. Tous les diagnostics sont alors enregistrés dans le fichier ou le syslog défini par error_log. Ceci peut être extrêmement utile dans un environnement de production, car les diagnostics sont enregistrés lorsqu'ils se produisent, et des rapports peuvent ensuite être générés à partir de ces journaux.

Les diagnostics individuels peuvent être supprimés à l'aide de l'opérateur @.

Note:

D'une version de PHP à l'autre, des diagnostics peuvent être ajoutés, supprimés, avoir leur niveau de gravité modifié ou être élevés au rang d'erreur Throwable.

<?php
function exceptions_error_handler($severity, $message, $filename, $lineno) {
    if (error_reporting() & $severity) {
        throw new ErrorException($message, 0, $severity, $filename, $lineno);
    }
}

set_error_handler('exceptions_error_handler');