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"); ?>