Pourquoi votre site PrestaShop affiche une erreur 500 (et comment la corriger)

Un jour tout fonctionne, et le lendemain… votre boutique PrestaShop affiche une erreur 500. Page blanche, message vague, parfois rien du tout. C’est typiquement le genre de panne qui bloque complètement les ventes, sans explication claire. Et contrairement à une erreur 404 ou 403, ici le problème vient du serveur — donc il faut creuser un peu plus.

Sur le terrain, ce type d’erreur revient souvent, surtout après une mise à jour, l’installation d’un module ou une modification serveur. Bonne nouvelle : dans la majorité des cas, on peut corriger ça rapidement à condition de savoir où regarder.

Ce que signifie réellement une erreur 500 sur PrestaShop

Une erreur HTTP 500 est une erreur côté serveur. En clair, votre hébergement n’arrive pas à exécuter correctement le code de votre site. Contrairement aux erreurs 400 (liées au navigateur ou à la requête utilisateur), ici le problème vient de la configuration, du code ou de l’environnement serveur.

Le souci, c’est que ce message est volontairement vague. PrestaShop n’affiche pas toujours le détail de l’erreur pour des raisons de sécurité. Résultat : vous voyez “Erreur 500” sans savoir si ça vient d’un module, d’un fichier, ou de PHP.

Les causes les plus fréquentes d’une erreur 500

En pratique, certaines causes reviennent régulièrement. Voici les plus courantes qu’on rencontre en maintenance :

1. Un fichier .htaccess corrompu ou mal configuré

C’est probablement la cause numéro un. Le fichier .htaccess gère les règles de réécriture d’URL et certaines configurations serveur. Une ligne incorrecte suffit à faire planter tout le site.

Ça arrive souvent après :

– une modification manuelle

– une migration

– un changement de version PHP

2. Un module défectueux ou incompatible

Un module mal développé ou pas à jour peut provoquer une erreur fatale. Typiquement :

– module non compatible avec votre version de PrestaShop

– conflit entre deux modules

– erreur PHP dans le code

On voit souvent ça après l’installation d’un module téléchargé hors marketplace officielle.

3. Une version PHP inadaptée

PrestaShop dépend fortement de la version de PHP utilisée. Une mise à jour automatique du serveur peut casser certaines fonctions.

Exemple concret : un site en PrestaShop 1.6 qui passe en PHP 8 sans adaptation… et l’erreur 500 apparaît immédiatement.

4. Des permissions de fichiers incorrectes

Si les droits d’accès aux fichiers sont mal définis, le serveur ne peut plus lire ou exécuter certains scripts.

En général :

– dossiers : 755

– fichiers : 644

Des permissions trop restrictives ou trop ouvertes peuvent déclencher des erreurs.

5. Une surcharge serveur ou un manque de ressources

Moins fréquent mais bien réel, surtout sur des hébergements mutualisés. Si votre site consomme trop de mémoire ou de CPU, le serveur peut renvoyer une erreur 500.

Comment afficher le détail de l’erreur (étape essentielle)

Tant que vous ne voyez pas l’erreur exacte, vous travaillez à l’aveugle. Sur PrestaShop, il faut activer le mode debug.

Pour cela :

– ouvrez le fichier /config/defines.inc.php

– remplacez :

define('_PS_MODE_DEV_', false);

par :

define('_PS_MODE_DEV_', true);

Rechargez la page. Cette fois, au lieu d’une erreur 500, vous aurez un message précis : fichier concerné, ligne, type d’erreur.

C’est souvent là que tout devient clair.

Comment corriger une erreur 500 sur PrestaShop (méthode concrète)

1. Tester le fichier .htaccess

Renommez temporairement le fichier .htaccess (ex : .htaccess_old), puis rechargez le site.

Si le site fonctionne à nouveau, le problème vient de là. Vous pouvez :

– régénérer le fichier depuis le back-office (SEO & URLs)

– ou recréer un fichier propre

2. Désactiver les modules récemment ajoutés

Si l’erreur est apparue après une installation :

– accédez au dossier /modules via FTP

– renommez le dossier du module suspect

PrestaShop le désactivera automatiquement.

Astuce terrain : commencez toujours par les modules de cache, sécurité ou paiement.

3. Vérifier la version PHP

Connectez-vous à votre hébergement (cPanel, Plesk, etc.) et testez une version compatible :

– PrestaShop 1.6 → PHP 5.6 à 7.2

– PrestaShop 1.7 → PHP 7.1 à 8.1 (selon version)

Un simple changement de version peut corriger immédiatement l’erreur.

4. Consulter les logs serveur

Les logs sont souvent plus parlants que l’écran blanc. Cherchez :

– fichier error_log

– journaux Apache ou Nginx

Vous y verrez des messages comme :

– “Fatal error”

– “Allowed memory size exhausted”

– “Permission denied”

Chaque message donne une piste concrète.

5. Vérifier les permissions

Via FTP :

– corrigez les droits si nécessaire

– évitez les permissions 777 (souvent bloquées par les serveurs)

6. Augmenter la mémoire PHP

Si vous voyez une erreur liée à la mémoire :

– modifiez le fichier php.ini ou .htaccess

– augmentez memory_limit (ex : 256M)

C’est fréquent sur des boutiques avec beaucoup de modules ou produits.

Cas concrets rencontrés en maintenance

Quelques situations typiques :

– Après migration vers un nouvel hébergeur : erreur 500 liée à PHP incompatible

– Installation d’un module de paiement obsolète → site complètement bloqué

– Activation du cache Smarty mal configuré → page blanche

– .htaccess cassé après modification d’URL SEO

Dans la majorité des cas, la panne ne vient pas de PrestaShop lui-même mais d’un élément autour : serveur, module, configuration.

Quand il vaut mieux se faire accompagner

Si vous n’avez pas accès aux logs, ou si l’erreur persiste malgré les tests de base, mieux vaut éviter de multiplier les modifications au hasard.

Une mauvaise manipulation peut :

– aggraver l’erreur

– casser d’autres fonctionnalités

– impacter le référencement

Dans un contexte pro (site e-commerce actif), chaque heure compte. Une intervention ciblée permet souvent de corriger l’erreur 500 en moins d’une heure quand le diagnostic est bien posé.