Opérateur de contrôle d'erreur

PHP supporte un opérateur de contrôle d'erreur : l'arobase (@). Lorsque cet opérateur est ajouté en préfixe d'une expression PHP, les diagnostics d'erreurs qui peuvent être générés par cette expression seront ignorés.

Si un gestionnaire d'erreur personnalisé est défini avec set_error_handler(), il sera quand même appelé même si le diagnostic a été ignorée.

Avertissement

Antérieur à PHP 8.0.0, le error_reporting() appelée dans le gestionnaire d'erreur personnalisé retournait toujours 0 si le l'erreur a été ignorée avec l'opérateur @. À partir de 8.0.0, il retourne la valeur E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE.

Tous les messages d'erreur générés par l'expression sont disponibles dans l'élément "message" du tableau retourné par la fonction error_get_last(). Le résultat de la fonction changera à chaque erreur, aussi, il convient de le vérifier souvent.


<?php
/* Erreur intentionnelle (le fichier n'existe pas): */
$mon_fichier = @file ('non_persistent_file') or
    die ("Impossible d'ouvrir le fichier : L'erreur est : '" . error_get_last()['message'] . "'");

// Cela fonctionne avec n'importe quelle expression, pas seulement les fonctions
  $value = @$cache[$key];
// la ligne ci-dessus n'affichera pas d'alerte si la clé $key du tableau n'existe pas

?>

Note: L'opérateur @ ne fonctionne qu'avec les expressions. La règle générale est : s'il est possible de prendre la valeur de quelque chose alors on peut préfixer l'opérateur @ à celui-ci. Par exemple, il peut être préfixé devant les variables, appels de fonctions, certains appels aux constructions de langages (e.g. include), etc. Il ne peut pas être préfixé devant les définitions de fonctions ou de classes ou structures conditionnelles telles que if et foreach, etc.

Avertissement

Antérieur à PHP 8.0.0, il était possible pour l'opérateur @ de désactiver les erreurs critiques qui terminait l'exécution du script. Par exemple, préfixer @ à un appel d'une fonction qui n'existe pas, en étant indisponible ou mal orthographiée, causait le script à se terminer sans aucune indication pourquoi.

Opérateur de contrôle d'erreur

Voir aussi