array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.trigger-error.php', 1 => 'trigger_error', 2 => 'Déclenche une erreur utilisateur', ), 'up' => array ( 0 => 'ref.errorfunc.php', 1 => 'Fonctions sur la gestion des erreurs', ), 'prev' => array ( 0 => 'function.set-exception-handler.php', 1 => 'set_exception_handler', ), 'next' => array ( 0 => 'function.user-error.php', 1 => 'user_error', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/errorfunc/functions/trigger-error.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 lorsqu'il faut 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. Tout caractère après les 1024 premiers octets sera ignoré.

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. Il convient d'utiliser la fonction htmlentities() sur le message si l'erreur doit être affichée dans un navigateur.

Voir aussi