(PHP 4, PHP 5)
error_log — Stocke un message d'erreur
$message
[, int $message_type = 0
[, string $destination
[, string $extra_headers
]]] )Envoie un message d'erreur à l'historique d'erreur du serveur web ou à un fichier.
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 :
| 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 | N'est plus une option. |
| 3 |
message est ajouté au fichier
destination. Aucune nouvelle ligne
(retour chariot) n'est automatiquement ajoutée à la fin de la chaîne
message.
|
| 4 |
message est envoyé directement au gestionnaire
d'identification SAPI.
|
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().
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
| Version | Description |
|---|---|
| 5.2.7 |
La valeur possible pour 4 a été ajoutée à message_type.
|
Exemple #1 Exemples avec error_log()
<?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 !", 3, "/var/tmp/mes-erreurs.log");
?>