error_log

error_log

(PHP 3, PHP 4, PHP 5)

error_log -- Enviar un mensaje de error a alguna parte

Descripci贸n

bool error_log ( string mensaje [, int tipo_mensaje [, string destino [, string cabeceras_extra]]] )

Env铆a un mensaje de error al registro del servidor web, a un puerto TCP o a un archivo.

Lista de par谩metros

mensaje

El mensaje de error a ser registrado.

tipo_mensaje

Indica a d贸nde debe ir el mensaje. Los tipos de mensaje posibles son los siguientes:

Tabla 1. Tipos de registro de error_log()

0 mensaje es enviado al registro de sistema de PHP, usando el mecanismo de registro del Sistema Operativo o un archivo, dependiendo del valor de la directiva de configuraci贸n error_log. Esta es la opci贸n predeterminada.
1 mensaje es enviado por correo electr贸nico a la direcci贸n en el par谩metro destino. Este es el 煤nico tipo de mensaje en donde el cuarto par谩metro, cabeceras_extra, es usado.
2 mensaje es enviado a trav茅s de la conexi贸n de depuraci贸n de PHP. Esta opci贸n est谩 disponible 煤nicamente si la depuraci贸n remota ha sido habilitada. En este caso el par谩metro destino indica el nombre de host o direcci贸n IP y, opcionalmente, el n煤mero de puerto del socket que recibe la informaci贸n de depuraci贸n. Esta opci贸n s贸lo est谩 disponible en PHP 3.
3 mensaje es agregado al final del archivo destino. Un salto de l铆nea no es agregado autom谩ticamente al final de la cadena mensaje.

destino

El destino. Su significado depende del par谩metro mensaje como se describi贸 anteriormente.

cabeceras_extra

Las cabeceras adicionales. Es usado cuando el par谩metro mensaje es definido a 1. Este tipo de mensaje usa la misma funci贸n interna que usa mail().

Valores retornados

Devuelve TRUE si todo se llev贸 a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Ejemplo 1. Ejemplos de error_log()

<?php
// Enviar una notificacion a traves del registro del servidor si no nos
// podemos conectar a la base de datos.
if (!Ora_Logon($nombre_usuario, $contrasenya)) {
    
error_log("La base de datos Oracle no esta disponible!", 0);
}

// Notificar al administrador por correo electronico si se agota FOO
if (!($foo = allocate_new_foo())) {
    
error_log("Problemas, se nos acaban los FOOs!", 1,
              
"operador@example.com");
}

// otras formas de llamar error_log():
error_log("Ha fallado!", 2, "127.0.0.1:7000");
error_log("Ha fallado!", 2, "host_registro");
error_log("Ha fallado!", 3, "/var/tmp/mis-errores.log");
?>