PrestaShop : un module a planté le site, que faire

Vous venez d'installer un nouveau module, ou d'en mettre un à jour, et votre boutique tombe. Erreur 500, page blanche, ou une fonction qui ne répond plus. Le lien de cause à effet est clair : c'est le module. La bonne nouvelle, c'est que ce type de panne se répare vite quand on sait où regarder.

Pourquoi un module casse une boutique

PrestaShop est modulaire, et c'est sa force. Mais un module s'insère profondément dans le fonctionnement du site. S'il est incompatible avec votre version de PrestaShop, avec votre version de PHP, ou s'il entre en conflit avec un autre module, il peut faire planter bien plus que sa propre fonction. Une erreur fatale dans un module gourmand ou mal codé se propage, et c'est toute la boutique qui affiche une erreur 500.

C'est d'ailleurs l'une des premières causes de panne PrestaShop, avec le cache et les problèmes de PHP.

Étape 1 : identifier le coupable

C'est facile quand la panne suit immédiatement une action : le dernier module installé ou mis à jour est le suspect numéro un. Notez son nom. Documentation PrestaShop

Si vous avez encore accès au back-office, désactivez-le depuis la liste des modules et rechargez. Si la boutique revient, vous tenez votre coupable.

Étape 2 : désactiver un module sans back-office

Souvent, le module a rendu l'administration inaccessible aussi. Il faut alors passer par le FTP.

Connectez-vous à votre serveur en FTP ou SFTP. Ouvrez le dossier modules à la racine de la boutique. Repérez le dossier du module suspect, il porte son nom technique.

Renommez ce dossier, par exemple monmodule en monmodule_off. PrestaShop ne le trouvera plus et cessera de le charger. Videz ensuite le cache en renommant le dossier var/cache, comme on l'explique pour la page blanche liée au cache Symfony.

Rechargez la boutique. Dans la plupart des cas, elle revient à la vie sans le module fautif.

Étape 3 : décider quoi faire du module

Une fois le site sauvé, il reste à traiter le module lui-même. Trois options selon les cas.

S'il vous est indispensable, cherchez une version compatible avec votre PrestaShop et votre PHP auprès de son éditeur.

S'il n'existe pas de version compatible, trouvez un équivalent récent qui rend le même service. C'est souvent plus rapide et plus sûr que de faire réparer un module abandonné.

S'il ne vous servait pas vraiment, profitez-en pour vous en passer. Chaque module en moins, c'est un risque de panne et un ralentissement en moins.

Éviter que ça recommence

La règle qui change tout : ne jamais installer ou mettre à jour un module directement en production. On teste sur une copie de la boutique, on vérifie que tout tient, et seulement ensuite on applique en ligne. C'est le même principe que pour mettre à jour PrestaShop sans tout casser. Une sauvegarde récente, comme décrit dans les sauvegardes PrestaShop automatiques, permet en plus de revenir en arrière en cas de pépin.

Si vos modules cassent régulièrement le site à chaque mise à jour, c'est le signe que votre boutique tourne sur une version trop ancienne pour son écosystème. Repartir sur une version PrestaShop 9 avec des modules compatibles règle le problème à la racine.

Et si vous êtes bloqué, boutique à terre, ne perdez pas de ventes à tâtonner : notre dépannage PrestaShop remet le site en ligne à partir de 95 €/h, et la maintenance PrestaShop teste chaque mise à jour en amont pour vous éviter la panne.

Pour aller plus loin : blog officiel PrestaShop · notes de version PrestaShop · versions PHP supportées · endoflife.date – PHP

Pour approfondir : marché numérique unique européen.

Pour approfondir : directive européenne sur l'accessibilité.