Activer temporairement le mode debug de PrestaShop

Le mode debug permet d'obtenir l'exception exacte lorsque PrestaShop masque l'erreur. Il peut afficher des chemins, des requêtes et des données internes à n'importe quel visiteur, en plus de réduire les performances : utilisez-le de préférence sur un clone ou restreignez temporairement l'accès.

Dans les versions actuelles, activez-le depuis Paramètres avancés > Performances > Mode debug. Reproduisez uniquement l'action qui échoue, conservez la trace et désactivez-le immédiatement.

Si vous ne pouvez pas accéder au back-office, faites une copie de config/defines.inc.php et remplacez :

define('_PS_MODE_DEV_', false);	

Par :

define('_PS_MODE_DEV_', true);	

Ne modifiez pas d'autres valeurs et ne laissez pas le mode actif pendant que vous enquêtez. La trace indique l'endroit où l'erreur s'est produite, mais ne prouve pas à elle seule quelle mise à jour, quel module ou quel changement l'a provoquée. Comparez l'heure avec les journaux de PrestaShop et de PHP.

Une fois terminé, remettez _PS_MODE_DEV_ à false, videz le cache si nécessaire et vérifiez depuis une autre session que l'erreur n'est plus affichée publiquement. PrestaShop 9 permet aussi de gérer cet état avec la commande officielle prestashop:debug.

Ne pas confondre debug et profiler

_PS_MODE_DEV_ contrôle le mode debug ; _PS_DEBUG_PROFILING_ est une option distincte d'analyse des performances. N'activez pas le profiler pour obtenir une erreur quelconque et ne laissez pas les données des requêtes visibles du public.

Le changement d'environnement peut régénérer des caches et modifier les temps de réponse. Si un incident ne disparaît qu'en mode debug, vérifiez aussi le cache et la configuration de l'environnement de production avant de le considérer comme résolu. Conservez la trace en privé et ne partagez pas de captures contenant des jetons, des données clients ou des requêtes complètes.