Gestion des erreurs PHP

Gestion des erreurs PHP

En PHP, la gestion des erreurs par défaut est très simple. Un message d'erreur est envoyé au navigateur avec le nom du fichier, le numéro de ligne et un message décrivant l'erreur.

Gestion des erreurs PHP

La gestion des erreurs est un élément important lors de la création de scripts et d'applications Web. Si votre code manque de codage de détection d’erreurs, le programme n’aura pas l’air professionnel et ouvrira la porte à des risques de sécurité.

Ce tutoriel couvre certaines des méthodes de détection d'erreurs les plus importantes en PHP.

Nous vous expliquerons différentes méthodes de gestion des erreurs : 🎜>· Rapport d'erreurs

Gestion des erreurs de base : utilisation de la fonction die()

Le Le premier exemple montre un script simple qui ouvre un fichier texte :

<?php
$file=fopen("welcome.txt","r");
?>

Si le fichier n'existe pas, vous obtiendrez une erreur comme celle-ci :

Avertissement : fopen(welcome.txt) [function .fopen] : échec de l'ouverture du flux :

Aucun fichier ou répertoire de ce type dans /www/runoob/test/test.php à la ligne 2

Pour éviter que les utilisateurs ne reçoivent des messages d'erreur comme celui ci-dessus, nous vérifions si le fichier existe avant d'y accéder :

<?php
if(!file_exists("welcome.txt"))
{
         die("文件不存在");
}
else
{
         $file=fopen("welcome.txt","r");
}
?>

Maintenant, si le fichier n'existe pas, vous obtiendrez un message d'erreur comme celui-ci :

Le code ci-dessus est plus efficace que le code précédent, cela est dû à un simple mécanisme de gestion des erreurs qui termine le script après une erreur.

Cependant, simplement mettre fin au script n'est pas toujours approprié. Examinons les fonctions PHP alternatives pour gérer les erreurs.

Création d'un gestionnaire d'erreurs personnalisé

Créer un gestionnaire d'erreurs personnalisé est très simple. Nous avons simplement créé une fonction dédiée qui peut être appelée lorsqu'une erreur survient en PHP.

La fonction doit être capable de gérer au moins deux paramètres (niveau d'erreur et message d'erreur), mais peut accepter jusqu'à cinq paramètres (facultatif : fichier, numéro de ligne et contexte d'erreur) :

error_function(error_level,error_message,

error_file,error_line,error_context)

Maintenant, créons une fonction à gérer

 :

function customError($errno, $errstr)
{
         echo "<b>Error:</b> [$errno] $errstr<br>";
         echo "脚本结束";
         die();
}

Le code ci-dessus est une simple fonction de gestion des erreurs. Lorsqu'il est déclenché, il obtient le niveau d'erreur et le message d'erreur. Il imprime ensuite le niveau d'erreur et le message, puis termine le script.

Maintenant que nous avons créé une fonction de gestion des erreurs, nous devons déterminer quand la déclencher.

Définir le gestionnaire d'erreurs

Le gestionnaire d'erreurs par défaut de PHP est le gestionnaire d'erreurs intégré. Nous allons transformer la fonction ci-dessus en gestionnaire d'erreurs par défaut lorsque le script est en cours d'exécution.

Le gestionnaire d'erreurs peut être modifié pour s'appliquer uniquement à certaines erreurs, afin que le script puisse gérer différentes erreurs de différentes manières. Cependant, dans ce cas, nous allons utiliser notre gestionnaire d'erreurs personnalisé pour toutes les erreurs :

set_error_handler("customError");

Puisque nous voulons que notre fonction personnalisée gère toutes les erreurs, set_error_handler() ne nécessite qu'un seul paramètre, et un deuxième paramètre peut être ajouté pour spécifier le niveau d'erreur.

Exemple

Testez ce gestionnaire d'erreurs en essayant de générer une variable qui n'existe pas :

<?php
// 错误处理函数
function customError($errno, $errstr)
{
         echo "<b>Error:</b> [$errno] $errstr";
}
// 设置错误处理函数
set_error_handler("customError");
// 触发错误
echo($test);
?>

La sortie du code ci-dessus ressemble à ceci :

Erreur : [8] Variable non définie : test

Déclencher une erreur

Au point du script où l'utilisateur saisit des données, il est utile de déclencher une erreur lorsque la saisie de l'utilisateur n'est pas valide. En PHP, cette tâche est accomplie par la fonction trigger_error().

Exemple

Dans cet exemple, si la variable "test" est supérieure à "1", une erreur se produira :

<?php

$ test=2;

if ($test>1)

{

trigger_error("La valeur de la variable doit être inférieure ou égale à 1");

}

?>

Le résultat du code ci-dessus est le suivant :

Remarque : La valeur de la variable doit être inférieure ou égale à 1

dans /www/test/runoob.php en ligne 5

Vous pouvez déclencher une erreur n'importe où dans le script En ajoutant le deuxième paramètre, vous pouvez spécifier le niveau d'erreur qui est déclenché.

Types d'erreurs possibles :

E_USER_ERROR - Erreur d'exécution fatale générée par l'utilisateur. L'erreur ne peut pas être récupérée. L'exécution du script a été interrompue.

· E_USER_WARNING - Avertissement d'exécution non fatal généré par l'utilisateur. L'exécution du script n'est pas interrompue.

· E_USER_NOTICE - Par défaut. Notifications d'exécution générées par l'utilisateur. Se produit lorsque le script détecte une erreur possible, mais peut également se produire lorsque le script s'exécute normalement.

Exemple

Dans cet exemple, si la variable "test" est supérieure à "1", l'erreur E_USER_WARNING se produit. Si E_USER_WARNING se produit, nous utiliserons notre gestionnaire d'erreurs personnalisé et terminerons le script :

<?php
// 错误处理函数
function customError($errno, $errstr)
{
         echo "<b>Error:</b> [$errno] $errstr<br>";
         echo "脚本结束";
         die();
}
// 设置错误处理函数
set_error_handler("customError",E_USER_WARNING);
// 触发错误
$test=2;
if ($test>1)
{
         trigger_error("变量值必须小于等于 1",E_USER_WARNING);
}
?>

La sortie du code ci-dessus ressemblera à ceci :

Erreur : [512] La valeur de la variable doit être inférieure supérieur ou égal à 1

Fin du script

Maintenant que nous avons appris comment créer nos propres erreurs et comment les déclencher, étudions la journalisation des erreurs.

Enregistrement des erreurs

Par défaut, PHP envoie les enregistrements d'erreurs au système de journalisation ou au fichier du serveur selon la configuration error_log dans php.ini. En utilisant la fonction error_log(), vous pouvez envoyer un journal d'erreurs à un fichier spécifié ou à une destination distante.

Vous envoyer un message d'erreur par e-mail est un excellent moyen d'être averti d'une erreur spécifiée.

Envoyer un message d'erreur par e-mail

Dans l'exemple ci-dessous, si une erreur spécifique se produit, nous enverrons un e-mail avec un message d'erreur et terminerons le script :

<?php
// 错误处理函数
function customError($errno, $errstr)
{
         echo "<b>Error:</b> [$errno] $errstr<br>";
         echo "已通知网站管理员";
         error_log("Error: [$errno] $errstr",1,
         "someone@example.com","From: webmaster@example.com");
}
// 设置错误处理函数
set_error_handler("customError",E_USER_WARNING);
// 触发错误
$test=2;
if ($test>1)
{
         trigger_error("变量值必须小于等于 1",E_USER_WARNING);
}
?>

Le la sortie du code ci-dessus est la suivante :

Erreur : [512] La valeur de la variable doit être inférieure ou égale à 1

L'administrateur du site Web a été averti

Reçu de le code ci-dessus L'email ressemble à ceci :

Erreur : [512] La valeur de la variable doit être inférieure ou égale à 1

Cette méthode ne convient pas à toutes les erreurs. Les erreurs générales doivent être enregistrées sur le serveur à l'aide du système de journalisation PHP par défaut.