error_log

(PHP 3, PHP 4 , PHP 5)

error_log -- Stocke un message d'erreur

Description

int error_log ( string message [, int message_type [, string destination [, string extra_headers]]] )

error_log() envoie un message d'erreur à l'historique du serveur web, à un port TCP ou un fichier. message est le message d'erreur qui doit être enregistré. message_type indique où le message doit être envoyé :

Tableau 1. Types de error_log()

0 message est envoyé à l'historique PHP, qui est basé sur l'historique système ou un fichier, en fonction de la configuration de error_log. C'est l'option par défaut.
1 message est envoyé par email à l'adresse destination. C'est le seul type qui utilise le quatrième paramètre extra_headers. Ce message utilise la même fonction interne que mail().
2 message est envoyé par la connexion de débogage PHP. Cette option n'est disponible que si l'option remote_debugging a été désactivée. Dans ce cas, le paramètre destination spécifie l'hôte ou l'adresse IP, et optionnellement le numéro de port, de la socket qui recevra les informations de débogage.
3 message est ajouté au fichier destination.

Note : Lorsque message_type est positionné à 3, une nouvelle ligne n'est pas automatiquement ajoutée à la fin de la chaîne message.

Avertissement

Le débogage à distance via TCP/IP est une fonctionnalité PHP 3 qui n'est pas disponible en PHP 4.

Exemple 1. Exemples avec error_log()

<?php
// Envoi une notification par l'historique du serveur, si la connexion à la base
// de données est impossible.
if (!Ora_Logon ($username, $password)) {
    
error_log ("Base Oracle indisponible!", 0);
}
// Indiquer à l'administrateur, par email, qu'il n'y a plus de FOO
if (!($foo = allocate_new_foo())) {
    
error_log ("Aya!, Il ne reste plus de FOO disponibles!", 1,
               
"operateur@mondomaine.com");
}
// D'autres manières d'appeler error_log():
error_log ("Grosse bourde!", 2, "127.0.0.1:7000");
error_log ("Grosse bourde!", 2, "loghost");
error_log ("Grosse bourde!", 3, "/var/tmp/my-errors.log");
?>