Mettre Prestashop en mode debug (toutes versions)
Contexte de version et références — 19 novembre 2026 — Publication initiale : 2017-06-06. Contexte éditorial actualisé le 19 novembre 2026.
Les exemples distinguent les générations PrestaShop 1.0–1.4 et 1.5–1.7. Les chemins et réglages doivent être confirmés dans la version installée ; les indications « toutes les versions » ne doivent pas être étendues aux versions actuelles. Reproduisez de préférence l’erreur en préproduction. Si un diagnostic en production est nécessaire, limitez l’accès, protégez les informations affichées et désactivez le debug immédiatement après le contrôle.
Bonjour tout le monde,
un petit article pour montrer comment afficher les erreurs de son Prestashop et ça en fonction de votre version.
Pourquoi mettre une boutique en mode debug ?
En mode de production, votre boutique n’affiche aucune erreur afin de ne pas gêner le visiteur pendant la navigation sur votre boutique en ligne.
Cependant, il se peut que votre boutique affiche une page blanche et vous bloque lors d’une étape. C’est à ce moment qu’il faut activer le mode de debug afin de savoir d’où vient le problème.
Comment afficher les erreurs de sa boutique Prestashop ?
Sur les versions historiques décrites ci-dessous, le diagnostic utilise un fichier de configuration accessible par SFTP. Le fichier et les réglages dépendent de la version installée :
pour la version 1.0 > 1.4.x
il faut modifier le fichier config.inc.php qui se trouve dans le dossier /config/ et de remplacer la ligne suivante:
par
Sauvegardez le fichier et le renvoyez le sur le ftp (si vous ne pouvez pas l’éditer en temps réel).
Pour les versions 1.5.x, 1.6.x et 1.7 c’est presque la même manipulation, le fichier est toujours dans le dossier /config, mais il s’agit du defines.inc.php, éditez le et remplacer la ligne:
par:
Sauvegardez le fichier et renvoyez le si nécessaire également.
Désactivez le mode debug après le diagnostic. Préférez la préproduction : les messages affichés peuvent exposer des chemins, des requêtes ou d’autres informations techniques.
Voila, vous savez à présent mettre votre boutique en mode « debug », vous pouvez plus facilement trouver les petites erreurs ou erreurs bloquantes sur votre boutique en ligne.
Edit: Depuis les nouvelles versions de PrestaShop 1.7, il vous est possible de le faire via l’administration de votre boutique.
Rendez vous dans Paramètres Avancés > Performance et activez le mode debug.

Enjoy 😉
Pour aller plus loin : Documentation PrestaShop actuelle · Diagnostic de votre installation.
