L’erreur 500 sur PrestaShop : comprendre avant d’agir
L’erreur 500 est l’une des pannes les plus stressantes pour un e-commercant. Votre boutique affiche une page blanche, vos clients ne peuvent plus commander, et le message “Internal Server Error” ne vous dit rien d’utile. La bonne nouvelle : dans la grande majorite des cas, la cause est identifiable et corrigeable rapidement. Pour une vue d’ensemble, consultez egalement mon article sur les erreurs courantes sur PrestaShop.
Diagnostic : localiser la source du probleme
Avant de tester des solutions au hasard, consultez les logs.
Logs PrestaShop
Les logs se trouvent dans var/logs/ (ou log/ sur les anciennes versions) :
tail -100 var/logs/prod.log
Cherchez les lignes “CRITICAL” ou “ERROR” — elles indiquent le fichier et la ligne responsable.
Logs serveur
Apache : /var/log/apache2/error.log. Nginx : /var/log/nginx/error.log. Votre hebergeur propose souvent un acces depuis son panel (cPanel, Plesk).
Mode debug
Si les logs ne suffisent pas, editez config/defines.inc.php :
define('_PS_MODE_DEV_', true);
PrestaShop affichera le message d’erreur PHP complet. Remettez a false une fois le probleme resolu — laisser le debug actif est un risque de securite.
Les causes les plus frequentes
1. PHP memory limit depasse
Symptome : Fatal error: Allowed memory size of X bytes exhausted
Augmentez memory_limit dans php.ini ou .htaccess :
memory_limit = 512M
PrestaShop 8 necessite 256 Mo minimum. Je recommande 512 Mo pour les boutiques de plus de 1 000 produits.
2. Fichier .htaccess corrompu
Symptome : erreur sur toutes les pages, front et back-office.
Renommez le fichier (mv .htaccess .htaccess.backup). Si le site revient, regenerez-le depuis Parametres de la boutique > Trafic et SEO.
3. Module incompatible ou defectueux
Symptome : erreur apres installation ou mise a jour d’un module. Le log mentionne /modules/nom_du_module/.
Desactivez le module via FTP ou base de donnees :
mv modules/nom_du_module modules/nom_du_module_disabled
4. Version PHP incompatible
Symptome : erreur apres un changement de version PHP ou une migration serveur.
Verifiez la version avec php -v et consultez la documentation officielle PrestaShop pour les compatibilites. Votre hebergeur propose un selecteur de version PHP dans son panel.
5. Cache corrompu
Symptome : erreur apres une modification dans le back-office ou une mise a jour.
Supprimez le cache manuellement :
rm -rf var/cache/prod/*
rm -rf var/cache/dev/*
Sur PrestaShop 1.6 : cache/smarty/compile/ et cache/smarty/cache/. Si le probleme revient regulierement, envisagez Redis pour un cache plus robuste.
6. Erreur de connexion a la base de donnees
Symptome : erreur de type PDOException ou SQLSTATE[HY000].
Verifiez les parametres dans app/config/parameters.php (PS 1.7+) ou config/settings.inc.php (PS 1.6). Testez la connexion : mysql -u votre_utilisateur -p -h localhost votre_base.
Ce que je constate en intervention
Sur mes interventions de maintenance, 80 % des erreurs 500 se resolvent en moins de 30 minutes. Les trois causes que je rencontre le plus : memory limit insuffisant (surtout apres ajout de modules), .htaccess corrompu par un module mal code, et cache non vide apres une mise a jour. Mon reflexe systematique : je commence toujours par les logs. Un tail -100 sur le fichier de log donne la reponse dans 9 cas sur 10. Les marchands qui me contactent ont souvent passe des heures a tester des solutions trouvees sur des forums alors que la reponse etait dans les logs depuis le debut.
Quand faire appel a un professionnel
Si l’erreur persiste malgre ces verifications, le probleme est probablement plus profond : conflit entre modules, corruption de base de donnees ou probleme d’infrastructure. Chaque heure d’indisponibilite a un cout direct sur votre chiffre d’affaires et votre referencement Google.
Un service de maintenance PrestaShop vous garantit une prise en charge rapide et un suivi preventif.
Passez a l’action
L’erreur 500 est rarement fatale. Procedez methodiquement : logs d’abord, mode debug si necessaire, puis testez les causes une par une. Et mettez en place une routine de maintenance pour prevenir ces incidents.
Demander un audit gratuit pour identifier et corriger les problemes de votre boutique PrestaShop.