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

# error_log

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

error_log — Envía un mensaje de error al gestor de errores definido

### Descripción

function 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

Esta función retorna `true` en caso de éxito o `false` si ocurre un 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().

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open