¿Cómo gestionar un error 500?

  • ¿Qué es un error 500?

    Un error HTTP 500 (Internal Server Error) corresponde a un error interno del servidor web.

    En un servidor que sirve páginas generadas por código PHP, indica que el servidor encontró un problema que le impide responder con normalidad. 

    Esto puede deberse a un error en el código PHP, una extensión faltante, un archivo corrupto, una mala configuración (php.ini, .htaccess), un desbordamiento de memoria, etc.

     

    Las causas pueden ser múltiples, pero lo primero que hay que hacer para entender el error 500 es consultar sus detalles y su traza.

  • ¿Cómo mostrar un error 500 en el front office?

    Notas previas sobre el modo debug/dev de PrestaShop y Symfony

    En general, el modo dev no debe activarse sin restricciones, ya que también se mostraría a los visitantes del sitio. Existen soluciones alternativas para activarlo solo mediante, por ejemplo, un parámetro en la URL o un filtrado por dirección IP cuando no es posible modificar la URL.

     

    A partir de PrestaShop 1.7 (es decir, incluyendo Symfony) : Para encontrar la causa de un error 500, activar el modo debug de Symfony no es necesariamente recomendable, ya que mostrará la página de error para el primer error/advertencia/aviso encontrado.

     

    Así, podría aparecer, por ejemplo, la página de error con el detalle de un aviso (rara vez relevante) cuando en realidad se busca identificar el error fatal (que es la verdadera causa del error 500).

     

    Erreur 500

     

    ¿Cómo activar la visualización?

    Para activar la visualización de errores de forma controlada, modifique el archivo /config/defines.inc.php añadiendo una condición en el siguiente bloque if :

     

    if (_PS_MODE_DEV_ === true || isset($_GET['debug_XXXXXXXXXXX']) )
    {
        @ini_set('display_errors', 'on');
        @error_reporting(E_ALL | E_STRICT);
        define('_PS_DEBUG_SQL_', true);
    }
    else
    {
        @ini_set('display_errors', 'off');
        define('_PS_DEBUG_SQL_', true);
    }

     

    Explicación :

    XXXXXXXXXXX siendo una cadena aleatoria de números/letras.

     

    Esta modificación permite activar el modo debug únicamente añadiendo un parámetro GET personalizado en la URL, por ejemplo :

    https://tusitio.com/?debug_XXXXXXXXXXX

     

    Ventajas de este método :

    • La visualización de errores solo se activa cuando se añade el parámetro en la URL, por lo que los visitantes normales no ven los errores.
    • Los avisos se muestran pero no bloquean la ejecución — hay que buscar el error "fatal" al final de la página.


  • ¿Cómo encontrar un error gracias a los logs del servidor?

    En el servidor

    Los logs de Apache se almacenan en el directorio /var/log/apache2/ :

    • access.log : Contiene el historial de todas las solicitudes HTTP recibidas por el servidor (URLs accedidas, códigos de respuesta, direcciones IP, etc.)
    • error.log : Contiene los errores PHP, los errores de Apache y todas las anomalías encontradas por el servidor.

     

    Notas: El nombre del archivo varía según el vhost. Termina en "access.log". Hay rotación/compresión de logs activa. La división de logs no ocurre exactamente a medianoche. Para consultar logs alrededor de medianoche, generalmente hay que revisar el archivo de log del día anterior.

     

    Acceso a los logs : Puede acceder a estos archivos de 2 maneras :

    1. Vía SFTP navegando directamente a la carpeta /var/log/apache2/

    2. Vía SSH usando comandos como tail -f /var/log/apache2/error.log para seguir los errores en tiempo real, o si la salida es demasiado extensa grep -F votreIP /var/log/apache2/nomdedomaine-error.log

     

    En algunas versiones de PrestaShop, los logs de PrestaShop se encuentran en el directorio /var/www/(Site)/var/logs/

     

    Notas : Se le proporcionó acceso SSH en el momento de la configuración de su alojamiento. Si ya no lo tiene, no dude en contactarnos en [email protected]

     

    En su navegador

    En 77-24, el acceso a los logs está disponible directamente desde el front office :

     

    Pasos para acceder a los logs :

    1. Conéctese a su cuenta de cliente en 772424.com y acceda a su suscripción.

    2. Haga clic en la pestaña Panel de control.

    3. En el panel de Accesos rápidos, haga clic en Registros.

    4. Será redirigido a la interfaz de logs, donde podrá conectarse directamente a la VM del cliente con sus credenciales para consultar los logs en tiempo real.

     

     

  • ¿Qué hacer con estos logs?

    Una vez que tenga el log disponible, podrá localizar el error. Este contendrá los detalles del error (un mensaje que explica la causa) y posiblemente una stacktrace (traza de llamadas) en el caso de un error PHP, lo que le permitirá corregir el problema.

     

    En su caso, transmítalo a su agencia para su tratamiento.