Boutique PrestaShop lente : activer le mode debug pour trouver l’origine du problème

Une boutique PrestaShop lente peut faire fuir les visiteurs, réduire les ventes et nuire au référencement. Un module défaillant, une erreur PHP, un thème mal optimisé ou un serveur surchargé peuvent ralentir l’affichage — parfois sans message visible. Le mode debug de PrestaShop aide à repérer certaines erreurs et à orienter le diagnostic.

Attention : le mode debug n’accélère pas le site. Il affiche davantage d’informations techniques et peut lui-même ralentir les pages. Activez-le de préférence sur une copie de test, puis désactivez-le après vos vérifications.

Avant de commencer : vérifiez où la boutique est lente

Essayez de déterminer si le ralentissement concerne toutes les pages ou seulement certaines d’entre elles. Comparez, par exemple, la page d’accueil, une fiche produit, le panier et le back-office. Notez également si la lenteur est constante ou si elle apparaît à certaines heures.

• Si le back-office et le site public sont lents, le serveur ou la base de données peuvent être en cause.
• Si seules certaines pages posent problème, examinez les modules et fonctionnalités utilisés sur ces pages.
• Si le ralentissement survient après une mise à jour ou l’installation d’un module, commencez par vérifier les changements récents.

Activer le mode debug depuis le back-office

Si vous pouvez accéder à l’administration, l’option se trouve généralement dans Paramètres avancés > Performances. Selon la version de PrestaShop, recherchez l’option de mode debug ou de débogage, activez-la, puis enregistrez les modifications.

Les intitulés peuvent varier légèrement selon la version et la langue de votre installation. Pour une boutique en production, préférez activer le mode sur un environnement de test plutôt que sur le site ouvert aux clients.

Activer le mode debug dans les fichiers

Si le back-office est inaccessible, vous pouvez modifier le fichier de configuration à l’aide du gestionnaire de fichiers de votre hébergeur ou d’un client SFTP.

1. Faites une sauvegarde des fichiers de la boutique, ou au minimum du fichier que vous allez modifier.
2. Ouvrez le fichier config/defines.inc.php à la racine de l’installation PrestaShop.
3. Repérez la définition de la constante _PS_MODE_DEV_.
4. Remplacez false par true, si nécessaire.
5. Enregistrez le fichier, puis rechargez la page concernée pour observer les éventuels messages d’erreur.

define('_PS_MODE_DEV_', true);

La ligne peut être présentée différemment selon la version de PrestaShop. Ne créez pas une seconde définition de la constante : modifiez celle qui existe déjà.

Comment interpréter les erreurs affichées

Le mode debug peut faire apparaître des erreurs PHP, des avertissements ou des traces techniques. Leur emplacement fournit souvent un premier indice :

• Le chemin d’un module apparaît dans l’erreur : vérifiez sa compatibilité, sa configuration et sa version. Désactivez-le temporairement sur un environnement de test pour voir si le problème disparaît.
• L’erreur concerne le thème : testez avec le thème par défaut, si cela peut être fait sans perturber les visiteurs.
• Une erreur de mémoire ou de délai d’exécution apparaît : demandez à l’hébergeur de vérifier les limites PHP et les ressources disponibles. Augmenter une limite ne résout toutefois pas forcément la cause initiale.
• Aucune erreur n’apparaît : le ralentissement peut venir d’un temps de réponse serveur élevé, de requêtes SQL coûteuses ou de ressources trop volumineuses. Le mode debug ne révèle pas tous les problèmes de performance.

Évitez de publier des captures d’écran ou des traces complètes sans les vérifier : elles peuvent contenir des chemins de fichiers, des informations sur l’environnement ou d’autres données utiles à un tiers.

Autres causes fréquentes d’une boutique PrestaShop lente

Cache mal configuré ou désactivé

Dans Paramètres avancés > Performances, vérifiez les réglages de cache et de compilation adaptés à votre installation. Après une modification, videz le cache PrestaShop et contrôlez le site. Les options disponibles dépendent notamment de la version, de l’hébergement et de la configuration du serveur.

Modules trop nombreux ou peu optimisés

Certains modules ajoutent des scripts, des requêtes ou des traitements sur chaque page. Examinez les modules récemment installés ou mis à jour. Désactivez-les un par un sur une copie de test afin d’identifier un éventuel responsable, plutôt que de supprimer plusieurs extensions simultanément.

Images et ressources trop lourdes

Des images de grande taille, des fichiers JavaScript ou CSS inutilisés et des polices chargées en trop grand nombre peuvent ralentir l’affichage. Redimensionnez et compressez les images, puis limitez les ressources réellement nécessaires sur chaque page.

Serveur ou base de données sous-dimensionnés

Un hébergement saturé, une version PHP inadaptée ou une base de données qui manque de ressources peut augmenter le temps de réponse. Demandez à votre hébergeur de vérifier la charge du serveur, les erreurs de ressources, la version PHP prise en charge et les journaux disponibles.

Cache vidé ou indexation en cours

Juste après avoir vidé le cache, PrestaShop peut devoir reconstruire certains éléments : les premières visites peuvent alors être plus lentes. Attendez quelques minutes et testez à nouveau avant de conclure que le changement a aggravé la situation.

Désactiver le mode debug après le diagnostic

Une fois les tests terminés, désactivez le mode debug depuis le back-office ou remettez la constante à false dans config/defines.inc.php :

define('_PS_MODE_DEV_', false);

Vérifiez ensuite que la boutique s’affiche normalement et qu’aucune information technique n’est visible publiquement. Si une erreur persiste, consultez les journaux PHP et ceux de PrestaShop, puis transmettez les éléments utiles à votre développeur ou à votre hébergeur.

En résumé

Le mode debug peut aider à repérer une erreur qui contribue à la lenteur d’une boutique PrestaShop, mais il ne constitue pas un outil complet de mesure des performances. Activez-le avec prudence, idéalement sur un environnement de test, analysez les erreurs sans modifier plusieurs éléments à la fois, puis désactivez-le. Pour des étapes détaillées, consultez notre guide pour activer le mode debug de PrestaShop.