Votre boutique ou votre back-office affiche un écran blanc ? Ce guide vous explique les causes et les étapes pour le résoudre. Besoin d'aide ? Nos experts interviennent en quelques minutes.
PrestaShop page blanche : comment diagnostiquer et corriger le problème
Causes et étapes pour résoudre. Nos experts interviennent en quelques minutes.
La page blanche (ou WSOD - White Screen of Death) sur PrestaShop est le symptôme d'une erreur PHP fatale que le serveur ne peut pas afficher. C'est l'un des problèmes les plus courants et les plus stressants : aucun message, aucun indice visible. Le site semble avoir tout simplement disparu.
C'est la cause n°1. Deux modules qui modifient le même hook, le même contrôleur ou la même classe provoquent une erreur fatale silencieuse. Le problème survient souvent après l'installation ou la mise à jour d'un module.
Une erreur de syntaxe dans un fichier PHP modifié, un override mal écrit ou une classe appelée mais absente provoquent un crash immédiat. PHP ne peut pas exécuter le code et renvoie un écran blanc.
PrestaShop utilise un système de cache intensif (Smarty pour le front, Symfony pour le back-office en 1.7+). Si le cache est corrompu (après une mise à jour interrompue, un déploiement partiel), le site affiche une page blanche.
Un script PHP qui dépasse le memory_limit est tué par le serveur sans message d'erreur visible. C'est fréquent avec les imports massifs, la régénération de miniatures ou les modules gourmands.
Une mise à jour de PrestaShop ou d'un module qui s'interrompt en cours de route (timeout, déconnexion) laisse le site dans un état incohérent. Certains fichiers sont mis à jour, d'autres non : résultat, page blanche.
Un thème qui n'est pas compatible avec votre version de PrestaShop, ou dont un fichier template contient une erreur Smarty, peut provoquer une page blanche sur tout le front-office.
Voici les étapes à suivre dans l'ordre pour diagnostiquer et corriger le problème :
Modifiez /config/defines.inc.php : passez _PS_MODE_DEV_ à true. Si une erreur PHP est en cause, elle apparaîtra en clair au lieu de la page blanche. Notez le message exact.
Via FTP, supprimez le contenu des dossiers /var/cache/prod/ et /var/cache/dev/ (PrestaShop 1.7+) ou /cache/smarty/compile/ et /cache/smarty/cache/ (PrestaShop 1.6). Ne supprimez pas les dossiers eux-mêmes, uniquement leur contenu.
Si le back-office est aussi en page blanche, vous ne pouvez pas désactiver les modules normalement. Accédez à phpMyAdmin, table ps_module, et passez le champ active à 0 pour le dernier module installé. Rechargez le site.
Depuis votre panneau d'hébergement, vérifiez que la version PHP est compatible avec votre PrestaShop. PrestaShop 1.7 : PHP 7.1 à 7.4. PrestaShop 8.x : PHP 7.4 à 8.1. PrestaShop 9 : PHP 8.1+.
Renommez le dossier /override/ en /override_bak/. Si le site revient, un override est en cause. Réintégrez-les un par un pour identifier le coupable.
Nos spécialistes PrestaShop diagnostiquent et corrigent votre page blanche en quelques minutes. Diagnostic gratuit.
Ouvrir un ticketC'est un cas particulier fréquent. Le front-office fonctionne, mais l'administration est inaccessible. Les causes spécifiques :
On corrige des pages blanches tous les jours depuis plus de 10 ans.
Vous décrivez le problème, on identifie la cause avant tout engagement.
On ne réinstalle pas, on ne formate pas. On identifie et on corrige le point de défaillance.
PrestaShop 1.6, 1.7, 8.x, 9 : on connaît les spécificités de chaque version.
2549 clients, 8867 bugs corrigés. L'expérience fait la différence sur les cas complexes.
La satisfaction client est notre meilleur argument.
Ils ont ouvert 8872 demandes de correction de bug, toutes corrigées avec succès
Chaque minute d'écran blanc, ce sont des ventes perdues. Décrivez le problème, on vous répond en moins de 10 minutes.
Ouvrir un ticketÀ partir de 49€ HT