Comment vider le cache de PrestaShop quand le back-office refuse de s'ouvrir ?

Un dirigeant constate que le back-office de sa boutique affiche une page blanche, une erreur 500 ou reste bloqué sur un écran de chargement, souvent juste après l'installation d'un module, une mise à jour de thème ou une modification manuelle de fichier. Dans la majorité des cas, le coupable est le cache de PrestaShop, qui a conservé une version obsolète ou corrompue des fichiers compilés. Vider ce cache manuellement, via un accès FTP, permet généralement de débloquer la situation en quelques minutes.

Comprendre pourquoi le cache bloque l'accès

PrestaShop utilise plusieurs couches de cache pour accélérer l'affichage : le cache Smarty (templates compilés), le cache Symfony (pour les pages du back-office en 1.6.1.x et 1.7+), et le Cache CDC (Combine, Compress, Cache) pour les ressources front. Lorsqu'un module est mal désinstallé, qu'un fichier de template est modifié sans repasser par l'admin, ou qu'une mise à jour échoue partiellement, ces caches peuvent contenir des références à des fichiers qui n'existent plus ou à du code incompatible. Résultat : PHP tente de charger un fichier compilé cassé et le back-office ne répond plus, parfois sans message d'erreur exploitable.

Accéder aux fichiers via FTP

Puisque le back-office est inaccessible, la seule solution est d'intervenir directement sur les fichiers du serveur, via un client FTP (FileZilla, Cyberduck) ou le gestionnaire de fichiers de l'hébergeur. Il faut impérativement faire une sauvegarde des dossiers avant toute suppression, même si l'opération est généralement sans danger : elle prend quelques secondes et évite toute mauvaise surprise.

Supprimer les dossiers de cache concernés

Une fois connecté en FTP, les dossiers à vider dépendent de la version de PrestaShop :

• PrestaShop 1.6 et antérieur : supprimer le contenu du dossier /cache/smarty/compile/ et /cache/smarty/cache/, en conservant les fichiers index.php présents dans ces dossiers.
• PrestaShop 1.7 et 8 : vider le contenu de /var/cache/prod/ (environnement de production) et /var/cache/dev/ si le mode debug est actif. Il faut supprimer tout le contenu de ces dossiers, pas les dossiers eux-mêmes.
• Cache CDC : si le problème touche l'affichage front, vérifier aussi /cache/c/ et les fichiers combinés dans /themes/votre-theme/cache/.

Après suppression, PrestaShop régénère automatiquement ces fichiers à la prochaine requête. Il suffit de recharger la page d'administration pour vérifier si l'accès est rétabli.

Si le problème persiste après le vidage du cache

Si le back-office reste inaccessible après avoir vidé le cache, plusieurs pistes complémentaires existent :

• Activer le mode debug en modifiant la variable _PS_MODE_DEV_ à true dans config/defines.inc.php (1.6) ou app/config/parameters.php / variables d'environnement (1.7+), pour afficher le message d'erreur réel au lieu d'une page blanche.
• Consulter les logs d'erreur PHP de l'hébergeur (souvent accessibles via cPanel ou le panneau d'administration de l'hébergement), qui indiquent précisément le fichier et la ligne en cause.
• Vérifier les droits d'accès (permissions) des dossiers /cache, /var et /log : ils doivent être accessibles en écriture par le serveur web (généralement 755 ou 775 selon la configuration).
• Si un module vient d'être installé, le désactiver en renommant son dossier dans /modules/ (ajouter un suffixe comme _disabled) pour voir si le problème disparaît.

Prévenir ce type d'incident

Pour limiter la récurrence de ce genre de panne, quelques réflexes réduisent le risque : toujours tester une mise à jour de module ou de thème sur un environnement de préproduction avant la mise en production, désactiver le mode cache avant toute modification manuelle de fichiers de template, et conserver une sauvegarde complète (fichiers et base de données) datant de moins de 24 heures avant toute intervention technique. La documentation officielle PrestaShop détaille la structure des dossiers de cache selon les versions sur devdocs.prestashop-project.org.

Besoin d'un diagnostic rapide et fiable ?

Quand le vidage de cache ne suffit pas ou que l'origine du blocage reste incertaine, un prestataire PrestaShop expérimenté peut intervenir en quelques heures pour diagnostiquer précisément la cause (module, thème, configuration serveur) et rétablir l'accès sans perte de données. Performeer PrestaShop met en relation les dirigeants de TPE et PME avec des prestataires qualifiés, de façon neutre et sans engagement, pour résoudre ce type d'incident rapidement.