trigger_error

    (PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

    trigger_error — Déclenche une erreur utilisateur

    Description

    trigger_error(string$message, int$error_level = E_USER_NOTICE): true

    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

    message

    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_level

    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

    Retourne toujours true.

    Erreurs / Exceptions

    Cette fonction lance une ValueError si le error_level n'est pas l'un des E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED.

    Historique

    VersionDescription
    8.0.0 La fonction lance désormais une ValueError si un error_level invalide est spécifié. Auparavant, elle retournait false.

    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

    Avertissement

    Les entités HTML contenues dans le paramètre message ne sont pas échappées. Utilisez la fonction htmlentities() sur le message si l'erreur doit être affichée dans un navigateur.

    Voir aussi

    To Top