PS PrestaShop Débutant

DataFirefly Cache Clear

Installer et utiliser le bouton « Vider le cache » de DataFirefly dans le back-office PrestaShop 8 et 9.

Mis à jour Version du module 1.1.0

Présentation

DataFirefly Cache Clear ajoute un bouton « Vider le cache » dans la barre d’outils du back-office de PrestaShop. Un clic purge les caches Smarty, XML, Media et Symfony, réinitialise l’OPcache PHP et vide le cache objet s’il est activé, sans passer par Paramètres avancés > Performances et sans recharger la page.

Installation

  1. Téléchargez l’archive dfclearcache.zip depuis votre compte DataFirefly.
  2. Dans le back-office, ouvrez Modules > Module Manager.
  3. Cliquez sur Téléverser un module et sélectionnez le ZIP.
  4. Le module s’installe et s’active automatiquement.

Aucune configuration n’est nécessaire : dès l’activation, le bouton apparaît dans la barre d’outils de toutes les pages d’administration.

Mise à jour depuis la 1.0.x

Téléversez le ZIP de la 1.1.0 dans Modules > Module Manager, par-dessus la version installée. Le script de mise à jour réinitialise l’OPcache pour que le nouveau code soit pris en compte immédiatement. Aucun réglage n’est à refaire.

Utilisation

  1. Cliquez sur le bouton « Vider le cache » dans la barre d’outils, à côté des actions de page et du bouton d’aide.
  2. L’icône tourne pendant l’opération. La purge s’exécute en AJAX, la page n’est pas rechargée.
  3. Une notification verte confirme l’opération et liste les caches vidés, par exemple « Cache vidé avec succès. (Smarty, XML, Media, Symfony, OPcache) ».

Ce qui est vidé

  • le cache Smarty (templates compilés du front et du back-office) ;
  • le cache XML ;
  • le cache des médias (CSS/JS combinés et minifiés) ;
  • le cache Symfony de PrestaShop 8/9 ;
  • l’OPcache PHP, si l’extension est active et que l’hébergeur autorise sa réinitialisation ;
  • le cache objet (Memcached, APCu), uniquement s’il est activé dans Paramètres avancés > Performances.

Le cache Symfony est vidé par le mécanisme natif de PrestaShop, en fin de requête. Si ce mécanisme n’est pas disponible, le module renomme le dossier var/cache de l’environnement courant puis le supprime après l’envoi de la réponse. Le dossier n’est donc jamais effacé pendant qu’une page l’utilise.

Qui voit le bouton

Le bouton n’est affiché qu’aux employés dont le profil a accès au module : les super-administrateurs et le profil de l’employé qui a installé le module. Les autres profils ne le voient pas, ce qui évite un bouton qui échouerait au clic.

Journal des purges

Chaque purge est enregistrée dans Paramètres avancés > Logs avec l’ID de l’employé, sous la forme « DataFirefly Cache Clear: cache cleared (Smarty, XML, Media, Symfony, OPcache) ». Une purge partielle apparaît avec une gravité « avertissement ».

Compatibilité

  • PrestaShop 8.0 à 9.x
  • PHP 7.4 à 8.x
  • Mono-boutique et multiboutique
  • Langues : FR, EN, ES, DE, IT, NL, PL, PT (anglais par défaut)
  • Hook utilisé : displayBackOfficeHeader

Dépannage

Le bouton n’apparaît pas

Vérifiez que le module est activé dans le Module Manager et que votre profil fait partie de ceux qui ont accès au module (voir « Qui voit le bouton »).

Message « Votre session a expiré »

Votre session back-office a expiré pendant que la page était ouverte. Rechargez la page, reconnectez-vous si besoin, puis cliquez de nouveau.

Message « Cache partiellement vidé »

Une étape a échoué, les autres ont été exécutées. Le détail de l’erreur s’affiche dans la console du navigateur (F12) et la purge apparaît en avertissement dans les logs. La cause la plus fréquente est un problème de droits d’écriture sur les dossiers de cache.

OPcache n’apparaît pas dans la notification

L’extension OPcache est désactivée, ou l’hébergeur restreint opcache_reset() (directive opcache.restrict_api). L’étape est alors sautée sans erreur. Ce n’est pas un dysfonctionnement du module.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support