trigger_error
(PHP 4 >= 4.0.1, PHP 5, PHP 7)
trigger_error — Déclenche une erreur utilisateur
Description
$error_msg
[, int $error_type = E_USER_NOTICE
] )trigger_error() est utilisé pour déclencher une erreur utilisateur. Elle peut aussi être utilisée en conjonction avec un gestionnaire d'erreurs interne, ou un gestionnaire d'erreurs utilisateur qui a été choisi comme gestionnaire d'erreurs avec set_error_handler().
trigger_error() est pratique lorsque vous devez générer une réponse particulière lors de l'exécution.
Liste de paramètres
-
error_msg -
Le message d'erreur désigné pour cette erreur. Il est limité en longueur à 1024 octets. Tous caractères après les 1024 octets seront ignorés.
-
error_type -
Le type d'erreur désigné pour cette erreur. Cela ne fonctionne qu'avec la famille de constantes E_USER et sera par défaut
E_USER_NOTICE.
Valeurs de retour
Cette fonction retourne FALSE si un paramètre incorrect est passé à
error_type, TRUE sinon.
Exemples
Exemple #1 Exemple avec trigger_error()
Voir set_error_handler() pour un exemple plus conséquent.
<?php
if ($divisor == 0) {
trigger_error("Impossible de diviser par zéro", E_USER_ERROR);
}
?>
Notes
Les entités HTML contenues dans le paramètre error_msg
ne sont pas échappées. Utilisez la fonction htmlentities()
sur le message si l'erreur doit être affichée dans un navigateur.
Voir aussi
- error_reporting() - Fixe le niveau de rapport d'erreurs PHP
- set_error_handler() - Spécifie une fonction utilisateur comme gestionnaire d'erreurs
- restore_error_handler() - Réactive l'ancienne fonction de gestion des erreurs
- Les constantes de niveau d'erreur
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.trigger-error.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
