# Comment activer le mode debug sur PrestaShop

> Le mode debug remplace la page blanche ou le message générique de PrestaShop par le détail technique exact de l’erreur : fichier, ligne, classe en cause. C’est la première chose à activer devant un problème qui ne s’explique pas de lui-même.

- Source canonique : [https://allaux.fr/guides/activer-mode-debug-prestashop](https://allaux.fr/guides/activer-mode-debug-prestashop)
- Langue : FR
- Dernière mise à jour : 2026-07-26

## Réponse directe

> Ouvrez config/defines.inc.php à la racine de PrestaShop et passez la constante _PS_MODE_DEV_ à true, puis rechargez la page en erreur : le message technique complet remplace l’écran blanc. Repassez-la à false dès le diagnostic terminé, jamais en production le reste du temps.

## Activer puis désactiver le mode debug

1. **Se connecter en FTP, SFTP ou SSH** — Le fichier à modifier n’est accessible ni depuis le back-office ni depuis l’admin : il faut un accès aux fichiers du serveur.
2. **Ouvrir config/defines.inc.php** — Ce fichier se trouve à la racine du dossier config/ de l’installation PrestaShop, quelle que soit la version 1.6, 1.7, 8 ou 9.
3. **Modifier la constante _PS_MODE_DEV_** — Repérez la ligne define('_PS_MODE_DEV_', false); et remplacez false par true, puis enregistrez le fichier.
4. **Recharger la page concernée** — Sur PrestaShop 1.7 et plus, une barre de débogage Symfony apparaît en bas de page avec les requêtes SQL exécutées, le temps de chargement et la pile d’erreur complète si une exception a été levée.
5. **Lire le message et remonter à la cause** — Le message indique le fichier, la ligne et souvent la classe ou le module fautif. C’est ce texte qu’il faut rechercher ou transmettre pour un diagnostic précis.
6. **Repasser la constante à false** — Une fois la cause identifiée et corrigée, remettez immédiatement _PS_MODE_DEV_ à false. Le laisser actif expose des détails techniques et parfois des données à n’importe quel visiteur.

## config/defines.inc.php

```
define('_PS_MODE_DEV_', true);
```

## Ce que le mode debug change concrètement

Sans mode debug, PrestaShop intercepte les erreurs PHP et Smarty et affiche à la place une page générique ou un écran blanc, pour ne rien exposer de sensible à un visiteur. C’est une protection utile en production, mais elle empêche aussi de voir ce qui s’est réellement passé.

Avec le mode debug actif, le comportement change selon la version. Sur PrestaShop 1.6, les erreurs PHP classiques et les erreurs de compilation Smarty s’affichent directement dans la page. Sur PrestaShop 1.7, 8 et 9, qui reposent sur le framework Symfony, le mode dev active en plus la barre de débogage Symfony (Symfony profiler) en bas de chaque page : elle liste les requêtes SQL exécutées, leur temps d’exécution, la mémoire consommée et, en cas d’exception, la pile d’appels complète avec le fichier et la ligne exacts.

Le mode debug agit aussi sur le comportement du cache : en développement, PrestaShop recompile les templates Smarty et recharge la configuration à chaque requête plutôt que de servir une version compilée. C’est plus lent, ce qui est une autre raison de ne jamais le laisser actif en permanence.

## Les erreurs courantes

- Oublier de repasser _PS_MODE_DEV_ à false après le diagnostic : le site expose alors des informations techniques à tous les visiteurs, et parfois des données de configuration.
- Modifier le fichier via l’éditeur de code intégré au back-office quand le back-office lui-même est inaccessible : dans ce cas, seul un accès direct aux fichiers fonctionne.
- Confondre le mode debug PrestaShop avec le mode debug PHP du serveur (display_errors) : les deux sont utiles mais n’affichent pas la même chose et se règlent à des endroits différents.
- Activer le mode debug sur une boutique dont le certificat SSL affiche encore des avertissements : la page technique révélée peut alors être visible en clair sur un réseau non sécurisé.

## FAQ

### Le mode debug peut-il casser quelque chose sur la boutique ?

Non, il ne modifie aucune donnée. Il change uniquement la façon dont PrestaShop affiche les erreurs et, sur 1.7 et plus, désactive certains caches de développement, ce qui ralentit temporairement le site sans l’endommager.

### Je n’ai pas d’accès FTP, comment faire ?

Il faut au minimum un accès aux fichiers du serveur, via FTP, SFTP, SSH ou le gestionnaire de fichiers du panneau d’hébergement. Sans cet accès, il n’est pas possible de modifier config/defines.inc.php.

### Le mode debug est activé mais l’écran reste blanc, pourquoi ?

Cela arrive quand l’erreur se produit avant même le chargement de PrestaShop, par exemple sur une erreur PHP fatale de bas niveau ou un fichier .htaccess invalide. Il faut alors consulter directement les logs du serveur.

### Faut-il activer le mode debug sur toute la boutique ou juste une page ?

La constante s’applique à l’ensemble du site, il n’existe pas de réglage par page. C’est justement pour cela qu’il doit rester actif le moins longtemps possible.

### Le message d’erreur affiché contient des informations sensibles, est-ce grave ?

Le risque est réel si le mode reste actif longtemps : chemins de fichiers, structure de la base ou requêtes SQL peuvent apparaître. Le corriger rapidement puis repasser en mode production limite ce risque à la durée du diagnostic.