error_log
(PHP 4, PHP 5)
error_log — Stocke un message d'erreur
Description
bool error_log
( string $message
[, int $message_type
[, string $destination
[, string $extra_headers
]]] )
Envoie un message d'erreur à l'historique du serveur web, à un port TCP ou un fichier.
Liste de paramètres
- message
-
Le message d'erreur qui doit être stocké.
- message_type
-
Spécifie la destination du message d'erreur. Les types possibles de messages sont :
error_log() log types 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 . 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. Cette option est uniquement disponible en PHP 3. 3 message est ajouté au fichier destination . Une nouvelle ligne est automatiquement ajoutée à la fin de la chaîne message . - destination
-
La destination. Cela dépend du paramètre message_type décrit ci-dessus.
- extra_headers
-
Les en-têtes supplémentaires. Ils sont utilisés lorsque le paramètre message_type est défini à 1. Ce type de message utilise la même fonction interne que la fonction mail().
Valeurs de retour
Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.
Exemples
Example#1 error_log() examples
<?php
// Envoie une notification par l'historique du serveur web,
// 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,
"[email protected]");
}
// 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/mes-erreurs.log");
?>