(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Déclenche une erreur utilisateur
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.
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
.
Passer E_USER_ERROR
comme
error_level
est désormais obsolète.
Lancez une Exception ou
appelez exit() à la place.
Retourne toujours true
.
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
.
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 .
|
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);
?>
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.