Blog

You are currently viewing Activer le mode Debug sur prestashop
Activer le mode Debug sur prestashop

Le mode Debug (ou mode développeur) est la première étape pour diagnostiquer une page blanche, une erreur 500 ou un comportement anormal d’un module. Selon la version de PrestaShop, le chemin diffère légèrement, mais l’idée reste la même : afficher les erreurs PHP et les logs Symfony. Voici comment procéder, sans passer par des tableaux.

PrestaShop 1.6

Depuis le Back‑Office

  1. Connectez‑vous à l’administration.
  2. Allez dans Paramètres avancés ▸ Performances.
  3. Activez « Mode débogage » puis enregistrez.

En modifiant un fichier

  1. Ouvrez le fichier config/defines.inc.php via FTP ou SSH.
  2. Repérez la ligne :define('_PS_MODE_DEV_', false);
  3. Passez la valeur à true.
  4. Sauvegardez puis videz le cache si nécessaire.

Limiter l’affichage aux développeurs
Si le site est en production, entourez la constante d’un test sur l’adresse IP pour n’afficher les erreurs qu’à vous :

if ($_SERVER['REMOTE_ADDR'] === '123.123.123.123') {
    define('_PS_MODE_DEV_', true);
}

PrestaShop 1.7

Activation via l’interface

  1. Dans le Back‑Office, ouvrez Paramètres avancés ▸ Performances.
  2. Faites passer le commutateur Mode Debug sur « Oui » et cliquez sur Enregistrer.

Fallback par fichier
Le fichier config/defines.inc.php contient toujours la constante _PS_MODE_DEV_. Passez‑la à true si l’admin est inaccessible.

Purge du cache
Parfois, le Back‑Office ne devient accessible qu’une fois le cache vidé manuellement : supprimez le contenu de var/cache/ puis rechargez la page.

Restriction aux IP
Utilisez le même snippet PHP que pour la 1.6 pour limiter la visibilité des erreurs.

PrestaShop 8

Chemin graphique (inchangé)
Rendez‑vous dans Paramètres avancés ▸ Performances et activez Mode Debug. La barre de debug Symfony apparaît alors en bas de l’écran.

Constante historique
_PS_MODE_DEV_ subsiste dans config/defines.inc.php, ce qui reste pratique pour les conteneurs Docker, les pipelines CI/CD ou lorsque l’interface ne répond plus.

Console Symfony (option avancée)
Après avoir activé le mode debug, exécutez :

php bin/console cache:clear --env=dev

Cette commande vide le cache de manière propre et évite certaines incohérences.

Filtrage par IP
La même logique qu’en 1.6/1.7 s’applique pour réserver l’affichage des erreurs à une ou plusieurs adresses IP.

Bonnes pratiques (toutes versions)

  • Désactivez toujours le mode debug en production ; les messages d’erreur peuvent exposer des chemins de fichiers ou des données sensibles.
  • Videz le cache après tout changement de thème ou de module ; cela évite de faux diagnostics.
  • Séparez vos environnements (dev, pré‑prod, prod) afin de conserver _PS_MODE_DEV_ = false ou APP_ENV=prod en boutique live.
  • Surveillez les performances : le mode debug désactive la minification et ajoute la barre d’outils, ce qui ralentit légèrement le site.

En résumé

  • PrestaShop 1.6 : pas de barre d’outils graphique ; le fichier defines.inc.php reste la solution de secours.
  • PrestaShop 1.7 : interrupteur visuel accessible + constante pour les cas critiques.
  • PrestaShop 8 : mêmes réglages, enrichis des commandes Symfony et d’une barre de debug plus complète.

En connaissant ces différentes méthodes, vous pourrez activer ou désactiver rapidement le mode debug, réduire le temps d’indisponibilité et diagnostiquer efficacement vos boutiques PrestaShop, quelle que soit leur version.

Laisser un commentaire