trigger_error
(PHP 4 >= 4.0.1, PHP 5)
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()
<?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
