Erreur 500 sur PrestaShop: causes et solutions

Votre boutique affiche une page blanche ou le message « Erreur 500 », parfois seulement sur une page, parfois partout, back-office compris. Bonne nouvelle: une erreur 500 n’est presque jamais une perte de données. C’est le serveur qui signale qu’un script PHP s’est arrêté, sans dire pourquoi. Tout l’enjeu est de retrouver le vrai message d’erreur: une fois qu’on l’a, la cause est généralement claire.

1. Notez ce qui a changé juste avant

Dans la grande majorité des cas, l’erreur suit un changement récent. Avant de toucher à quoi que ce soit, notez:

• une mise à jour de PrestaShop, d’un module ou du thème;
• l’installation ou la configuration d’un nouveau module;
• un changement chez l’hébergeur: nouvelle version de PHP, migration de serveur, limite de mémoire modifiée;
• une modification de fichier faite à la main (thème, override, .htaccess).

Si vous avez une sauvegarde d’avant ce changement, gardez-la de côté: c’est votre filet de sécurité.

2. Affichez le vrai message d’erreur, pour vous seul (mode debug)

PrestaShop masque les erreurs aux visiteurs, ce qui est normal. Pour les voir, il faut activer le mode debug. Mais le réglage du back-office (Paramètres avancés › Performances › Mode debug) l’active pour tout le monde: vos clients verraient eux aussi les messages techniques, avec les chemins des fichiers du serveur. Mieux vaut le réserver à votre adresse IP:

1. Trouvez votre adresse IP: tapez « mon adresse IP » dans un moteur de recherche.
2. Dans le fichier config/defines.inc.php, remplacez define('_PS_MODE_DEV_', false); par define('_PS_MODE_DEV_', ($_SERVER['REMOTE_ADDR'] ?? '') === '203.0.113.10');, en mettant votre adresse à la place de 203.0.113.10.
3. Rechargez la page en erreur: vous seul voyez le message, qui indique le fichier, la ligne et souvent le module en cause. Vos clients voient toujours la page d’erreur habituelle.

Cette méthode fonctionne aussi quand le back-office est inaccessible. Si votre boutique passe par Cloudflare, vérifiez que le serveur voit bien votre vraie adresse, et non celle de Cloudflare (voir le guide Cloudflare, point 8). Une fois le diagnostic terminé, remettez la ligne d’origine, define('_PS_MODE_DEV_', false);: le mode debug ralentit la boutique, et le réglage du back-office ne pourra plus le modifier tant que la ligne est changée.

3. Lisez les journaux d’erreurs

Si le mode debug n’affiche rien, ou si l’erreur est intermittente, les journaux en disent plus:

• le dossier var/logs/ de PrestaShop (versions 1.7, 8 et 9);
• le journal d’erreurs PHP de l’hébergement, accessible depuis le panneau de l’hébergeur ou dans un fichier error_log.

Cherchez les lignes « PHP Fatal error » ou « Uncaught Exception » à l’heure où l’erreur s’est produite.

4. Les causes les plus fréquentes, et comment les corriger

Un module incompatible ou défectueux

C’est la cause numéro un, surtout après une mise à jour. Si le message cite un dossier modules/nom-du-module/, désactivez ce module. Sans accès au back-office, renommez simplement son dossier (par exemple nom-du-module-off): PrestaShop ne le chargera plus. Dans le back-office, Paramètres avancés › Performances permet aussi de désactiver d’un coup les modules non natifs, pour vérifier si l’un d’eux est en cause.

Une version de PHP non prise en charge

Chaque version de PrestaShop fonctionne avec une plage précise de versions de PHP. Par exemple, PrestaShop 1.7.8 ne fonctionne pas avec PHP 8, PrestaShop 8 s’arrête à PHP 8.1, et PrestaShop 9 demande au moins PHP 8.1. Si votre hébergeur a changé la version de PHP, revenez à une version compatible depuis son panneau, puis planifiez une vraie mise à jour de la boutique.

Un cache corrompu

Après une mise à jour interrompue, le cache peut contenir des fichiers incohérents. Videz-le depuis Paramètres avancés › Performances, ou supprimez le contenu des dossiers var/cache/prod et var/cache/dev: PrestaShop le reconstruit tout seul.

Un override en conflit

Les overrides modifient le cœur de PrestaShop. Un override écrit pour une ancienne version provoque souvent une erreur 500 après une mise à jour. Le réglage « Désactiver tous les overrides » (Paramètres avancés › Performances) permet de le vérifier en quelques secondes.

Une limite de mémoire trop basse

Le message contient alors « Allowed memory size exhausted ». PrestaShop recommande au moins 256 Mo pour memory_limit. Ce réglage se fait chez l’hébergeur, ou dans un fichier de configuration PHP selon l’offre.

Un fichier .htaccess abîmé ou des droits incorrects

Une règle invalide dans le .htaccess provoque une erreur 500 sur tout le site. Pour le régénérer, enregistrez simplement la page Paramètres de la boutique › Trafic et SEO. Vérifiez aussi les droits: en général 755 pour les dossiers et 644 pour les fichiers.

Un piratage

Des fichiers inconnus à la racine, du code illisible ajouté en haut de index.php, des redirections étranges: dans ce cas, ne vous contentez pas de corriger l’erreur. Il faut nettoyer, fermer la faille et changer tous les mots de passe.

5. Après la correction

• Remettez la ligne d’origine du mode debug dans config/defines.inc.php.
• Testez une commande complète: panier, paiement, e-mail de confirmation.
• Gardez une trace de la cause, pour éviter qu’elle revienne à la prochaine mise à jour.

Pour la suite, la meilleure prévention reste simple: des sauvegardes automatiques, et des mises à jour testées d’abord sur une copie de la boutique.