Erreur 500 PrestaShop ou page blanche : que faire dans les 15 premières minutes
Quand PrestaShop affiche une erreur 500 ou une page blanche, vérifiez d’abord si toute la boutique est touchée ou une page. Activez ensuite le mode debug ou lisez le journal d’erreurs pour le vrai message. Causes habituelles : un module mis à jour, un changement de version de PHP, la limite de mémoire du serveur. En urgence, désactivez un module en renommant son dossier.
Auteur: L’équipe TellMyShop. Un guide pour les propriétaires de boutiques PrestaShop : la cause, la correction manuelle et le même travail dans une conversation avec le chat.
Dernière mise à jour: · 6 min de lecture
Étape zéro : qu’est-ce qui a cessé de fonctionner exactement ?
Avant de changer quoi que ce soit, notez trois choses. Elles décident si vous réglerez le problème vous-même en un quart d’heure ou s’il vous faut de l’aide.
| Question | Si oui | Cause probable |
|---|---|---|
| Toute la boutique et le back office sont-ils en panne ? | une erreur au démarrage de PrestaShop | PHP, mémoire, fichier endommagé, module chargé partout |
| La boutique est en panne mais le back office fonctionne ? | une erreur dans le thème ou un module du front office | un module modifié récemment, le thème, un override |
| Une seule page est en panne, comme le panier ou une fiche produit ? | une erreur dans un module greffé sur cette page | un module de paiement, de livraison ou de fiche produit |
| Quelque chose a-t-il changé dans les dernières 24 heures ? | c’est presque toujours la cause | une mise à jour de module, de PHP ou du thème, une migration |
La dernière ligne compte le plus. Une erreur 500 apparue une heure après la mise à jour d’un module se révèle en général être la faute de ce module. Commencez par annuler le dernier changement avant de chercher ailleurs.
Comment voir le vrai message d’erreur
L’erreur 500 seule ne vous dit rien. Deux endroits montrent le vrai message, avec le fichier et le nom du module.
- Le mode debug. Quand le back office fonctionne, vous l’activez dans Paramètres avancés > Performances. Quand le back office est en panne, vous passez
_PS_MODE_DEV_àtruedans le fichierconfig/defines.inc.php. Nous décrivons les deux façons, et comment le désactiver sans risque, dans notre article sur le mode debug de PrestaShop. LH.pl le montre aussi pas à pas (en polonais). - Le journal d’erreurs du serveur. Dans votre panneau d’hébergement, en général sous « error log » ou « logs PHP ». Il montre les erreurs même quand vous ne voulez pas activer le debug sur une boutique en ligne.
- Les logs PrestaShop. Paramètres avancés > Logs contient les erreurs que PrestaShop a réussi à enregistrer, avec leur date. C’est utile quand l’erreur ne touche qu’une partie de la boutique.
Après le diagnostic, désactivez le mode debug. Il montre des détails techniques à chaque visiteur.
Les causes les plus fréquentes et que faire
Un module après une mise à jour. Le message désigne un fichier du dossier modules/nom_du_module. Désactivez le module dans le back office, et si le back office est en panne, renommez son dossier par FTP. Signalez ensuite l’erreur à l’auteur du module avec le texte du message.
La version de PHP. Votre hébergeur a changé PHP, ou vous l’avez changé vous-même dans le panneau d’hébergement. Les anciens modules ne fonctionnent pas sur un PHP plus récent, et PrestaShop 8 et 9 ont leurs propres exigences. Vérifiez la configuration requise de PrestaShop et revenez à la version précédente de PHP si l’erreur est apparue juste après le changement.
La mémoire et le disque. Un message sur « Allowed memory size », ou plus d’espace sur le disque. C’est l’affaire de votre hébergeur : augmenter la limite de mémoire PHP ou libérer de l’espace.
Les overrides et le cache. Après la désinstallation d’un module, un fichier d’override reste parfois et renvoie à du code qui n’existe plus. Vider le contenu de var/cache et vérifier le dossier override aide.
Des fichiers endommagés ou une infection. Quand rien n’a changé et que des morceaux de code inconnus sont apparus dans les fichiers, il s’agit peut-être d’une attaque. Pskrk décrit un tel cas (en polonais). Il vous faut alors une sauvegarde et un spécialiste, pas des réparations maison. Zenbox a réuni une liste plus large de pannes (en polonais).
Quand le chat aide, et quand il n’aide pas
Quand PrestaShop ne répond plus du tout, votre chat (Claude ou ChatGPT) ne peut pas aider, car le module TellMyShop tourne à l’intérieur de la boutique et tombe avec elle. Il vous reste alors le plan ci-dessus, ou un développeur.
Le chat est utile quand la boutique fonctionne mais qu’une partie a une erreur, et en prévention. Dans la version gratuite TellMyShop Free, le chat lit les logs d’erreurs d’une période choisie, la revue technique de la boutique et la liste des modules, puis explique les messages en langage simple.
Vous: Depuis ce matin, des clients écrivent que le panier ne s’ouvre pas. Hier, j’ai mis à jour deux modules. Vérifie ce qui se passe.
Votre chat: Les logs des dernières 24 heures contiennent 46 entrées de la même erreur, la première hier à 21:14, quelques minutes après la mise à jour du module de livraison.
L’erreur vient d’un fichier de ce module et se produit à l’ouverture du panier. L’autre module mis à jour n’a pas d’erreurs.
L’étape la plus sûre : désactiver le module de livraison jusqu’à ce que l’auteur publie un correctif. Les clients perdront ce mode de livraison, mais le panier fonctionnera à nouveau.
Désactiver un module via le chat fonctionne dans TellMyShop Pro avec l’interrupteur Modules activé dans le panneau du module. L’interrupteur reste actif 24 heures et exige une sauvegarde de la base de données faite le même jour. Un module désactivé garde ses données : vous pouvez donc le réactiver par une seule demande. Avec les modules de paiement et de livraison, le chat vous prévient de ce que les clients perdront. Exemples de demandes : messages d’erreur après la mise à jour d’un module, corriger une page d’erreur après une mise à jour et désactiver un module qui casse le panier.
Comment réduire le risque de la prochaine erreur 500
- Sauvegardez les fichiers et la base de données avant chaque mise à jour de module ou de PHP.
- Mettez à jour un module à la fois et vérifiez la boutique après chacun.
- Faites les mises à jour le matin d’un jour ouvré, pas le vendredi soir.
- Passez en revue les logs d’erreurs une fois par semaine, avant qu’une petite erreur ne grossisse.
- Gardez une copie de préproduction de la boutique pour tester les changements plus importants.
Si la boutique fonctionne mais que vos modifications ne s’affichent pas, c’est un autre problème : les modifications ne s’affichent pas dans PrestaShop.
Questions et réponses
Que signifie l’erreur 500 dans PrestaShop ?
Que le serveur a rencontré une erreur dans le code de la boutique et n’a pas pu construire la page. Le message lui-même ne dit pas ce qui s’est passé. Seuls le mode debug ou le journal d’erreurs du serveur montrent la cause. Le coupable habituel est un module après une mise à jour, un changement de version de PHP, ou un manque d’espace ou de mémoire sur le serveur.
Comment désactiver un module quand le back office PrestaShop ne fonctionne pas ?
Par FTP ou avec le gestionnaire de fichiers de votre hébergeur, renommez le dossier du module dans le dossier modules, par exemple en ajoutant _off à la fin. PrestaShop ne trouvera pas le module et l’ignorera. Rétablissez le nom une fois le problème réglé. C’est une sortie de secours : notez ce que vous avez changé pour pouvoir revenir en arrière.
L’erreur 500 peut-elle venir de mon hébergeur ?
Oui. Une limite de mémoire PHP dépassée, un disque plein, une extension PHP désactivée ou un changement de version de PHP par l’hébergeur produisent tous la même erreur 500. Si les logs montrent un message sur la mémoire ou une extension manquante, c’est l’affaire de votre hébergeur, pas de l’auteur du module.
Le chat peut-il aider quand toute la boutique est en panne ?
Non, car le module TellMyShop tourne à l’intérieur de la boutique. Quand PrestaShop ne répond plus du tout, la connexion avec le chat ne fonctionne pas non plus. Le chat aide quand l’erreur touche une partie de la boutique, comme une page ou le panier, et en prévention : la revue des logs d’erreurs après chaque mise à jour.
PrestaShop est une marque déposée de PrestaShop SA. Claude est une marque d’Anthropic PBC. ChatGPT et OpenAI sont des marques d’OpenAI. TellMyShop n’est pas affilié à ces entreprises.