(PHP 4, PHP 5, PHP 7)
error_log — Envoi un message d'erreur vers le gestionnaire d'erreurs défini
$message
[, int $message_type = 0
[, string $destination
[, string $extra_headers
]]] ) : boolEnvoie un message d'erreur à l'historique d'erreur du serveur web ou à un fichier.
messageLe message d'erreur qui doit être stocké.
message_typeSpé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.
La fonction error_log() n'est pas sûr, au niveau binaire.
Le paramètre message sera tronqué par un caractère nul.
Le paramètre message ne doit pas contenir de caractère
nul. Notez que le paramètre message peut être envoyé
vers un fichier, un mail, syslog, etc. Utilisez les fonctions appropriées de
conversion/échappement, base64_encode(), rawurlencode()
ou addslashes() avant d'appeler la fonction error_log().
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");
?>
| Version | Description |
|---|---|
| 5.2.7 |
Le paramètre message_type peut désormais prendre
4 comme valeur.
|