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_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

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
error_get_last | Niveau supérieur | error_reporting