Comment gérer une erreur 500 ?

  • Qu’est ce qu’une erreur 500 ?

    Une erreur HTTP 500 (Internal Server Error) correspond à une erreur interne du serveur Web.

    Sur un serveur qui sert des pages générées par du code PHP, elle indique que le serveur a rencontré un problème l’empêchant de répondre normalement.

    Cela peut provenir d’une erreur de code PHP, d’une extension manquante, d’un fichier corrompu ou d’une mauvaise configuration (php.ini, .htaccess), d’un dépassement de mémoire, etc.

     

    Les causes peuvent être multiples, mais la première chose à faire pour comprendre l’erreur 500 est de consulter le détail de celle-ci ainsi que sa trace.

  • Comment afficher une erreur 500 en front office ?

    Notes préalables PrestaShop sur le mode debug/dev et Symfony 

    De manière générale, le mode dev ne doit pas être activé sans restriction, sinon il s’affiche aussi pour les internautes. Il existe des contournements pour ne l’activer qu’avec par exemple un passage de paramètre dans l’URL ou encore un filtrage par adresse IP lorsque la modification de l’URL n’est pas possible.

     

    À partir de PrestaShop 1.7 (càd incluant Symfony) : Pour trouver la cause d’une erreur 500, l'affichage du mode debug Symfony n'est pas forcément recommandé car il va afficher la page d’erreur pour la première erreur/avertissement/notice rencontré.

     

    Vous aurez ainsi par exemple la page d’erreur affichant le détail d’une notice (peu souvent impactante) alors que vous cherchez à avoir l’erreur fatale (qui est la cause de l’erreur 500).

     

    Erreur 500

     

    Comment déclencher l’affichage ?

    Pour activer l'affichage des erreurs de manière contrôlée, modifiez le fichier /config/defines.inc.php en ajoutant une condition dans le if suivant :

     

    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);
    }

     

    Explication :

    XXXXXXXXXXX étant une suite de chiffres/lettres au hasard.

     

    Cette modification permet d'activer le mode debug uniquement en ajoutant un paramètre GET personnalisé dans l'URL, par exemple :

    https://votresite.com/?debug_XXXXXXXXXXX

     

    Avantages de cette méthode :

    • L’affichage des erreurs n'est activé que lorsque vous ajoutez le paramètre dans l'URL, donc les visiteurs normaux ne voient pas les erreurs
    • Les notices sont affichées mais ne bloquent pas, il faut chercher l’erreur “fatale” en bas de page


  • Comment retrouver une erreur grâce aux logs serveur ?

    Sur le serveur

    Les logs Apache sont stockés dans le répertoire /var/log/apache2/ :

    • access.log : Contient l'historique de toutes les requêtes HTTP reçues par le serveur (URL accédées, codes de réponse, adresses IP, etc.)
    • error.log : Contient les erreurs PHP, les erreurs Apache et toutes les anomalies rencontrées par le serveur

     

    Notes : Le nom du fichier varie en fonction du vhost. Il se termine par "access.log". Une journalisation / compression est en place. Le découpage des logs ne se fait pas à minuit pile. Pour consulter des logs autour de minuit, il faut généralement consulter le fichier de log de la veille.

     

    Accès aux logs : Vous pouvez accéder à ces fichiers de 2 manières :

    1. Via SFTP en naviguant directement dans le dossier /var/log/apache2/

    2. Via SSH en utilisant des commandes comme tail -f /var/log/apache2/error.log pour suivre les erreurs en temps réel ou si la sortie est trop verbeuse grep -F votreIP /var/log/apache2/nomdedomaine-error.log

     

    Sur certaines version de PrestaShop, les logs PrestaShop se trouvent dans le répertoire /var/www/(Site)/var/logs/

     

    Notes : Un accès SSH vous a été fourni lors de la mise en place de votre hébergement. Si vous ne l’avez plus en votre possession, n’hésitez pas à nous contacter sur [email protected]

     

    Sur son navigateur

    Chez 77-24, l'accès aux logs est disponible directement depuis le front office :

     

    Étapes pour accéder aux logs :

    1. Connectez-vous sur votre compte client 772424.com et accédez à votre abonnement

    2. Cliquez sur l'onglet Tableau de bord

    3. Dans l'encart Accès rapides, cliquez sur Journaux

    4. Vous serez redirigé vers l'interface de logs où vous pourrez vous connecter directement à la VM cliente avec vos identifiants pour consulter les logs en temps réel

     

     

  • Que faire de ces logs ?

    Une fois le log à votre disposition, vous pouvez retrouver votre erreur. Celle-ci contiendra les détails de l’erreur (une erreur explicitant la cause), voir une stacktrace (trace d’appel) dans le cas d’une erreur PHP, ce qui vous permettra de corriger votre souci.

     

    Le cas échéant, transmettre à votre agence pour traitement.