Vous vous connectez à votre back-office PrestaShop et là, rien. Une page blanche, aucun message. Le front de la boutique fonctionne peut-être encore, mais l'administration est inaccessible. Pas de panique : dans la grande majorité des cas, la cause est connue et la réparation prend deux minutes.
La cause numéro un : le cache Symfony
Depuis PrestaShop 1.7, l'administration repose sur Symfony, qui met en cache des fichiers pour aller plus vite. Quand ce cache se corrompt, le back-office ne sait plus quoi afficher et renvoie une page blanche. C'est un grand classique, documenté depuis des années.
Le cache se corrompt typiquement après une mise à jour, l'installation ou la suppression d'un module, un changement de version de PHP, ou une interruption au mauvais moment. Bonne nouvelle : le cache n'est que du temporaire, on peut le supprimer sans rien risquer.
La réparation, étape par étape
Connectez-vous à votre serveur en FTP ou en SFTP, avec les identifiants fournis par votre hébergeur. Un logiciel comme FileZilla fait l'affaire.
Rendez-vous à la racine de votre boutique, puis ouvrez le dossier var. À l'intérieur, vous trouverez un dossier cache.
Renommez ce dossier cache en cache_old, ou supprimez son contenu. PrestaShop le régénérera tout seul au prochain chargement.
Rechargez votre back-office. Dans la plupart des cas, il s'affiche à nouveau.
Ne touchez à rien d'autre. Le dossier var/cache ne contient aucune donnée métier, seulement des fichiers techniques recréés automatiquement.
Si la page blanche revient
Vider le cache règle le symptôme, pas toujours la cause. Si l'écran blanc revient rapidement, c'est qu'un problème plus profond régénère un cache défaillant.
Pour savoir ce qui se passe vraiment, activez le mode debug. Dans le fichier config/defines.inc.php, passez la ligne _PS_MODE_DEV_ à true. PrestaShop affichera alors l'erreur réelle au lieu de la page blanche. Vous saurez enfin quel module ou quel fichier pose problème. Pensez à repasser cette valeur à false une fois le diagnostic fait, pour ne pas exposer d'informations techniques à vos visiteurs.
Les trois coupables habituels : un module incompatible avec votre version de PrestaShop ou de PHP, une version de PHP inadaptée, ou un fichier du cœur corrompu. Si vous soupçonnez PHP, on a détaillé le sujet dans PrestaShop et PHP 8. Si c'est un module, voyez un module qui plante le site.
Quand la page blanche cache un vrai problème de fond
Si votre boutique multiplie ce genre d'incidents à chaque mise à jour, ce n'est pas un hasard. C'est souvent le signe d'une version de PrestaShop vieillissante, avec des modules qui ne suivent plus. À ce stade, vider le cache encore et encore ne fait que repousser le problème.
La vraie solution est alors de repartir sur une base saine, ce qui passe par une migration vers PrestaShop 9. Une boutique à jour, avec des modules compatibles, tombe beaucoup moins souvent en panne.
Vous n'êtes pas à l'aise avec le FTP, ou l'écran blanc résiste ? On répare ça pour vous : notre dépannage PrestaShop démarre à 150 € sans abonnement. Et pour ne plus jamais y penser, la maintenance PrestaShop surveille et corrige avant que vous ne voyiez le problème.
