Erreur 500 Prestashop : guide correction 2025 !

1. Pourquoi une erreur 500 apparaît-elle après l’installation d’un module sur PrestaShop ?

Une erreur 500 peut survenir après l’installation d’un module mal codé, incompatible avec la version de PrestaShop, ou qui entre en conflit avec un autre module. Elle signifie que le serveur rencontre une erreur interne, souvent liée à un fichier PHP corrompu ou à une surcharge de mémoire.

Pour résoudre le problème, il faut activer le mode debug dans le fichier defines.inc.php, ce qui affichera le message d’erreur exact. Cela permet d’identifier rapidement le module fautif et de le désactiver via FTP ou en renommant son dossier dans /modules. Une vérification des logs serveur est également conseillée.

2. Comment corriger une erreur 500 sur la page d’administration de PrestaShop ?

Quand l’erreur 500 se produit dans le back-office, elle est souvent liée à une mise à jour incomplète, à un module défectueux, ou à une incompatibilité PHP. Un fichier manquant ou mal configuré dans /admin peut aussi en être la cause.

La première étape est d’activer le mode debug pour lire l’origine du plantage. Ensuite, via FTP ou cPanel, vous pouvez désactiver les modules récents ou restaurer une sauvegarde de la version précédente. Il faut également vérifier que la version PHP utilisée est compatible avec votre version de PrestaShop.

3. Une erreur 500 peut-elle être causée par un problème de thème PrestaShop ?

Oui, un thème mal conçu ou modifié sans respecter les bonnes pratiques peut générer une erreur 500, notamment s’il contient du code PHP erroné dans un fichier .tpl ou un override. Cela se produit souvent après des personnalisations non testées.

Pour identifier le problème, activez le thème par défaut (Classic) via la base de données ou FTP pour voir si le problème disparaît. Si oui, cela confirme que le thème personnalisé est responsable. Il est alors conseillé de corriger les erreurs dans les fichiers du thème ou de demander une assistance au développeur.

4. Quels fichiers faut-il vérifier en priorité lors d’une erreur 500 sur PrestaShop ?

Les fichiers à vérifier en priorité sont error.log (dans le serveur), les fichiers de log de PrestaShop (/var/logs), ainsi que index.php, defines.inc.php, et les overrides personnalisés. Les erreurs sont souvent liées à un mauvais appel de fonction, une dépendance manquante ou une surcharge système.

Il faut aussi jeter un œil au fichier .htaccess : une mauvaise configuration (réécriture d’URL, cache, sécurité) peut entraîner une erreur 500. La suppression temporaire de ce fichier et sa régénération via le back-office (une fois l’accès rétabli) peuvent parfois résoudre le souci.

5. Est-ce qu’une mise à jour PrestaShop peut provoquer une erreur 500 ?

Oui, une mise à jour mal effectuée peut provoquer des erreurs 500, surtout si les modules ou le thème actif ne sont pas compatibles avec la nouvelle version. Des fichiers manquants ou non migrés correctement peuvent interrompre l’exécution PHP.

Il est crucial de faire une sauvegarde avant toute mise à jour. En cas d’erreur 500, vous pouvez restaurer cette sauvegarde, ou activer le mode debug pour identifier les fichiers ou lignes de code responsables. Utiliser un outil comme 1-Click Upgrade avec vérification de compatibilité limite ces risques.

6. Comment activer le mode debug pour diagnostiquer une erreur 500 sur PrestaShop ?

Pour activer le mode debug, ouvrez le fichier /config/defines.inc.php et remplacez la ligne define('_PS_MODE_DEV_', false); par define('_PS_MODE_DEV_', true);. Cela affiche les erreurs PHP directement dans le navigateur au lieu d’un message générique.

Ce mode permet de localiser précisément l’origine de l’erreur, qu’il s’agisse d’un module, d’un thème ou d’un fichier de configuration. Une fois l’erreur corrigée, n’oubliez pas de désactiver le mode debug, car il peut afficher des informations sensibles aux visiteurs du site.

7. Est-ce qu’un problème de mémoire PHP peut causer une erreur 500 sur PrestaShop ?

Oui, si PrestaShop dépasse la limite de mémoire allouée à PHP (memory_limit), le serveur retourne une erreur 500. Cela peut se produire lors du chargement de nombreuses images, de grosses bases de données, ou de modules gourmands en ressources.

Il est possible d’augmenter cette limite en modifiant le fichier php.ini (ex. memory_limit = 512M) ou via .htaccess ou ini_set dans certains cas. Vérifiez aussi que le serveur supporte les exigences de PrestaShop, notamment la version PHP et les extensions nécessaires.

8. Les permissions de fichiers peuvent-elles provoquer une erreur 500 ?

Oui, des permissions incorrectes sur les fichiers et dossiers peuvent générer des erreurs 500. Par exemple, si un dossier a une permission 777 ou un fichier 000, le serveur peut bloquer son exécution pour des raisons de sécurité.

La règle générale est de mettre les dossiers en 755 et les fichiers en 644. Il faut aussi s'assurer que le propriétaire des fichiers correspond bien à celui de l'utilisateur Apache ou Nginx. En cas de doute, une réinitialisation des permissions via FTP ou SSH peut corriger la situation.

9. Comment corriger une erreur 500 après un changement d’hébergement PrestaShop ?

Après une migration, une erreur 500 peut apparaître si le serveur n’est pas configuré de façon compatible (ex : version PHP, extensions manquantes, mauvais chemin vers les dossiers temporaires, etc.). Les paramètres de base comme base_url ou les connexions à la base de données peuvent aussi être en cause.

Commencez par vérifier les logs serveur et activer le mode debug. Assurez-vous que le fichier .htaccess est compatible avec le nouvel environnement. Il faut aussi vérifier le fichier parameters.php dans /app/config/ ou /config/ pour ajuster les paramètres liés au serveur.

10. Est-ce que l’erreur 500 peut être liée à un problème de base de données sur PrestaShop ?

Oui, une erreur 500 peut provenir d’un problème avec la base de données : table manquante, corruption, ou mauvaise configuration dans parameters.php. Un module peut également faire un appel SQL invalide provoquant le plantage de la page.

En mode debug, une erreur SQL sera visible, indiquant généralement la ligne fautive. Il faut vérifier l’état de la base via phpMyAdmin, réparer les tables si nécessaire, ou restaurer une sauvegarde. Pour prévenir ce genre de souci, une optimisation régulière de la base est recommandée.