trigger_error

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

trigger_errorDé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.

Avertissement

Passer E_USER_ERROR comme error_level est désormais obsolète. Lancez une Exception ou appelez exit() à la place.

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

Version Description
8.4.0 Passer E_USER_ERROR comme error_level est désormais obsolète. Lancez une Exception ou appelez exit() à la place.
8.4.0 La fonction a désormais un type de retour true au lieu de bool.
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
$password
= $_POST['password'] ?? '';
if (
$password === '') {
trigger_error("Using an empty password is unsafe", E_USER_WARNING);
}
$hash = password_hash($password, PASSWORD_DEFAULT);
?>

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