error_log

(PHP 4, PHP 5, PHP 7, PHP 8)

error_logEnvía un mensaje de error al gestor de errores definido

Descripción

error_log(
    string $message,
    int $message_type = 0,
    ?string $destination = null,
    ?string $additional_headers = null
): bool

Envía un mensaje de error al historial de errores del servidor web o a un fichero.

Parámetros

message

El mensaje de error que debe ser almacenado.

message_type

Especifica el destino del mensaje de error. Los tipos posibles de mensajes son:

error_log() tipos de registro
0 message es enviado al historial PHP, que se basa en el historial del sistema o un fichero, dependiendo de la configuración de error_log. Esta es la opción por omisión.
1 message es enviado por email a la dirección destination. Este es el único tipo que utiliza el cuarto parámetro additional_headers.
2 Ya no es una opción.
3 message es añadido al fichero destination. No se añade automáticamente una nueva línea (retorno de carro) al final de la cadena message.
4 message es enviado directamente al gestor de identificación SAPI.

destination

El destino. Esto depende del parámetro message_type descrito anteriormente.

additional_headers

Los encabezados adicionales. Estos son utilizados cuando el parámetro message_type está definido a 1. Este tipo de mensaje utiliza la misma función interna que la función mail().

Valores devueltos

Devuelve true en caso de éxito o false en caso de error. Si message_type es cero, entonces esta función siempre retorna true, independientemente de si el error pudo ser registrado en el registro de eventos.

Historial de cambios

Versión Descripción
8.0.0 destination y additional_headers ahora son nullables.

Ejemplos

Ejemplo #1 Ejemplos con error_log()

<?php
// Envía una notificación por el historial del servidor web,
// si la conexión a la base de datos es imposible.
if (!Ora_Logon($username, $password)) {
error_log("Base Oracle no disponible !", 0);
}

// Indicar al administrador, por email, que no hay más FOO
if (!($foo = allocate_new_foo())) {
error_log("¡Ay!, No quedan más FOO disponibles !", 1,
"operador@example.com");
}

// Otras maneras de llamar a error_log():
error_log("¡Gran error !", 3, "/var/tmp/mis-errors.log");
?>

Notas

Advertencia

La función error_log() no es segura a nivel binario. El parámetro message será truncado por un carácter nulo.

Sugerencia

El parámetro message no debe contener caracteres nulos. Tenga en cuenta que el parámetro message puede ser enviado hacia un fichero, un correo, syslog, etc. Utilice las funciones apropiadas de conversión/escape, base64_encode(), rawurlencode() o addslashes() antes de llamar a la función error_log().