Manuel PHP
Précédent |  | Suivant

# error_log

(PHP 3, 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 où le message d'erreur doit aller. Les types possibles de messages sont :

  Tableau 1. 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 décrit ci-dessus.

extra_headers

  Les en-têtes supplémentaires. Ils sont utilisés lorsque le paramètre message 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

Exemple 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,
"operateur@example.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/mes-erreurs.log");
?>`

Précédent | Sommaire | Suivant
debug_print_backtrace | Niveau supérieur | error_reporting