error_log
En esta página
error_log
Envía un mensaje de error al gestor de errores definido
Descripción#
error_log(string $message, [int $message_type], [string $destination], [string $additional_headers]): bool
```php
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:
| | |
|----|----|
| 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](#ini.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. |
`error_log` tipos de registro
`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
Ejemplos con `error_log`
```php
Notas#
[!WARNING] La función
error_logno es segura a nivel binario. El parámetromessageserá truncado por un carácter nulo.[!TIP] El parámetro
messageno debe contener caracteres nulos. Tenga en cuenta que el parámetromessagepuede ser enviado hacia un fichero, un correo, syslog, etc. Utilice las funciones apropiadas de conversión/escape,base64_encode,rawurlencodeoaddslashesantes de llamar a la funciónerror_log.