En PHP el registro (log) de errores sirve para:
Enviar un mensaje de error a las rutinas de manejo de errores
definidas
Este archivo contiene por tanto información valiosa sobre los errores que podrían estar ocurriendo en nuestro programa.
Sería la primera fuente a consultar para determinar dónde ocurre el error exactamente, ya que dicho registro da información sobre la ruta del script fallido, la causa del fallo y el número de línea donde se encuentra el error.
Una de las mayores dificultades de un registro de errores, sobre todo al principio, es que suele arrojar muchísima información (esto se agradecerá posteriormente), en inglés, y eso echa para atrás a cualquiera, sobre todo si no dominas la lengua de Shakespeare, y lo digo por experiencia propia, porque los registros de error me daban alergia al principio. Pero con un poco de paciencia, si le metes mano y aprendes a interpretarlos, te vas a ahorrar muchas, pero muchas horas en la depuración / corrección de errores.
Otra dificultad añadida, en entornos de servidor, es que puede no ser fácil identificar dónde se encuentra el archivo que registra los errores, porque su ubicación puede variar según la configuración del servidor, el sistema operativo, etc. O también dicho registro puede estar deshabilitado, en cuyo caso los errores no se registran.
Pero hay formas de saber todo esto y es lo que voy a explicar a continuación.
Consideremos esta respuesta usando dos vías para encontrar tan importante fuente de información.
La vía rápida
Nos permitirá al menos saber cómo se llama nuestro archivo. Sabiendo su nombre, podremos buscar su ubicación más fácilmente.
Para ello podemos ejecutar en una página cualquiera:
phpinfo();
Esta llamada mostrará toda la configuración de nuestro PHP. Suele ser mucha información, por lo que puedes hacer una búsqueda con la palabra error
por ejemplo. De paso compruebas si el registro (log) de errores está o no activado.
Aquí está casi todo lo que nos interesa saber:
- que el archivo en este caso se llama
error_log
(primer recuadro en amarillo)
- que la escritura de errores está activada:
log_errors
: On (segundo recuadro en amarillo, casi al final). No confundir con lo que dice arriba: display_errors
, que está en Off
. Eso es para que no se muestren los errores en la pantalla del cliente.
Ahora sólo nos queda buscar la ubicación de nuestro archivo de errores. La cual puede variar según el contexto. Por ejemplo en mi caso: hosting compartido Bluehost para una página web, se crea un archivo en cada carpeta. Cuando un archivo de esa carpeta falla, se escribe en el log de errores.
Otra cosa a tomar en cuenta es que los últimos errores se escriben siempre al final del archivo, no al principio del mismo. Si hay muchísimos errores el archivo puede crecer, incluso muchos megabytes. Para evitar eso, lo primero es tener un código optimizado claro está, evitando que ocurran mensajes del tipo Undefined index... No seas vago y verifica las variables antes de intentar usarlas. Y, este archivo se puede ir limpiando cada N
meses por ejemplo. Algunos hosting lo hacen automáticamente, o lo puedes hacer tú manualmente, por ejemplo, borrando el archivo (en ese caso se creará uno nuevo cuando hayan de nuevo errores) o seleccionando todo su contenido y borrándolo.
IMPORTANTE: No olvides borrar la llamada a phpinfo()
una vez obtenida la información requerida, podrías estar dejando expuesta
información sensible sobre tu sitio, sobre todo si es una página web.
La vía directa (según tu plataforma)
Aquí una tabla para completar con la ubicación del log de errores según los frameworks o hostings más usados.
La respuesta es Wiki de comunidad, si tienes experiencia con algún entorno / framework, tómate 3 minutos para editarla, poniendo en la última fila la forma en que se accede al log de errores.
Cuida de no estropear la tabla. Al escribir alguna rayita vertical se moverá, re-colócala de forma que quede debajo de las otras.
╔═════════════════════════╦════════════════╦═════════════════════════════════════╗
║ Framework ║ Nombre ║ Ruta del archivo ║
║ o Hosting ║ de archivo ║ O Recurso Web (Pluggin) ║
╠═════════════════════════╬════════════════╬═════════════════════════════════════╣
║ Bluehost ║ error_log ║ Carpeta de cada script (*) ║
║-------------------------║----------------║-------------------------------------║
║ Symfony ║ monolog-bundle ║ No definida; Recurso 1 ║
║-------------------------║----------------║-------------------------------------║
║ phpCake ║ error.log ║ $app/tmp/logs/ ║
║-------------------------║----------------║-------------------------------------║
║ PHP Nativo ║ error-log ║ funcion Nativa de PHP; Recurso 2 ║
║-------------------------║----------------║-------------------------------------║
║ PHP Nativo ║ set-error-hand ║ funcion Nativa de PHP; Recurso 3 ║
║-------------------------║----------------║-------------------------------------║
║ Laravel (stack) ║ laravel.log ║ ./storage/logs/ ║
║-------------------------║----------------║-------------------------------------║
║-Laravel (daily) ║ log-[date].log ║ ./storage/logs/ ║
║-------------------------║----------------║-------------------------------------║
║ ║ ║ ║
║-------------------------║----------------║-------------------------------------║
║ ║ ║ ║
║-------------------------║----------------║-------------------------------------║
║ ║ ║ ║
║-------------------------║----------------║-------------------------------------║
║ ║ ║ ║
╚═════════════════════════╩════════════════╩═════════════════════════════════════╝
(*) Es importante señalar que el error se escribirá en la carpeta del script que llama. Si por ejemplo, tengo un script llamado llamador.php
que funciona bien, pero llama otro archivo con error que se llama llamado.php
que está en otra carpeta. El error se escribirá en la carpeta donde se encuentra llamador.php
, aunque sea llamado.php
el que falle. Por supuesto, el log nos dirá que error está en llamado.php
.
Recurso 1: Link
Recurso 2: Link
Recurso 3: Link
Log de errores en desarrollo
Si estamos desarrollando en Windows con Xampp (versión 3.x) el log de errores de PHP está accesible siguiendo los siguientes pasos:
- Abrir el panel de control de XAMPP.
- Para el servicio Apache clicar el botón "Logs".
- Seleccionar "PHP (php_error_log)"
Es una opción poco utilizada ya que si tenemos display_errors en ON, "normalmente" el propio intérprete nos mostrará los errores, pero puede ser necesaria cuando trabajamos con código de terceros en el que se han silenciado los errores dentro del propio código.
Log de errores propios de frameworks
Los frameworks y algunas otras herramientas pueden implementar su propio sistema de logs que registran errores y ,en ocasiones, otro tipo de mensajes.
Los logs de Laravel 5 podemos encontrarlos en el directorio "storage/logs/".