Un écran complètement vide. Pas de message, pas de texte, rien. Juste du blanc.
C’est ce qu’on appelle le « White Screen of Death » et c’est — de loin — l’un des appels les plus fréquents qu’on reçoit chez CYBERIAL. Le marchand est en panique (c’est normal), il pense que ses données sont perdues et il a déjà essayé 3 ou 4 trucs au hasard qui ont empiré la situation !
Alors, première chose : vos données sont intactes 🙂
Clients, commandes, catalogue — tout est là. La page blanche, ça veut simplement dire que le script PHP qui devait assembler votre page a planté en cours de route. Il n’a rien cassé, il a juste arrêté de travailler.
Quelle est le différence en une page blanche et une erreur 500 sur PrestaShop ? L’erreur 500 vous montre au moins un message — « Internal Server Error ». La page blanche, elle, ne montre rien du tout. PHP a planté si tôt qu’il n’a même pas eu le temps d’envoyer un code d’erreur au navigateur. C’est plus flippant, mais paradoxalement, c’est souvent plus simple à corriger.
Tout le diagnostic repose sur une seule question : où exactement apparaît cette page blanche ?
Page blanche sur le front ou back-office ?
C’est la première question qu’on pose systématiquement et ça change tout.
Seul le front-office est en page blanche
Vos clients voient un écran vide, mais vous, vous accédez au back-office sans problème. Dans ce cas, c’est quasiment toujours un problème de thème ou de module côté visiteur. Le back-office a ses propres fichiers — il peut tourner impeccablement pendant que le front est à plat.
Mon conseil : activez le thème « classic » (le thème par défaut de PrestaShop). Si la page revient, votre thème est en cause. Simple, rapide, et ça oriente tout de suite la suite du diagnostic.
Seul le back-office est en page blanche
Le front fonctionne — vos clients naviguent et commandent — mais vous, impossible d’accéder à l’admin. C’est le scénario le plus courant sur PS 1.7 et les versions suivantes.
La cause n°1, et de très loin : le cache Symfony corrompu. Je vous en reparle en détail dans les solutions plus bas, mais sachez que c’est tellement fréquent que le bug est documenté sur le GitHub officiel de PrestaShop depuis la version 1.7.4. Au moins cinq issues distinctes. PrestaShop le sait, mais n’a jamais vraiment corrigé le problème dans le cœur du logiciel.
La bonne nouvelle : ça se résout en 2 minutes par FTP.
Front et back-office sont en page blanche
Là, c’est un problème plus profond. Incompatibilité PHP (typiquement l’hébergeur qui a upgradé sans prévenir), mémoire insuffisante, ou base de données injoignable. C’est aussi le scénario le plus proche de l’erreur 500 — sauf qu’ici, PHP plante si tôt qu’il ne renvoie même pas de code d’erreur.
Certaines pages seulement sont blanches
Cas intéressant que personne ne traite — et pourtant on le voit régulièrement. La page d’accueil fonctionne, mais les pages produit sont blanches. Ou l’inverse.
- Pages produit blanches + reste OK : regardez du côté de l’URL rewriting (fichier
.htaccesscorrompu) ou d’un template Smarty manquant pour ce type de page. - Pages catégorie blanches : souvent un dépassement de mémoire sur les catégories avec beaucoup de produits (300+), parce que chaque produit génère des requêtes SQL.
Le tableau qu’on utilise en interne
| Où est le blanc ? | Première action |
|---|---|
| Front-office seul | Activer le thème « classic » |
| Back-office seul | Supprimer /var/cache/prod/ par FTP |
| Partout | Vérifier version PHP + memory_limit |
| Pages produit seules | Régénérer le .htaccess (SEO & URLs) |
| Après avoir cliqué sur « Vider le cache » | Supprimer /var/cache/ par FTP (pas par le BO !) |
Ce dernier cas mérite un mot : oui, le bouton « Vider le cache » du back-office peut lui-même provoquer une page blanche. C’est un bug documenté sur GitHub. Passez toujours par FTP pour cette opération.
Recherche l’erreur avec le mode debug PrestaShop
Face à une page blanche, le réflexe n°1 c’est de forcer PrestaShop à afficher l’erreur qu’il cache. Par défaut, PrestaShop masque toutes les erreurs PHP. C’est bien pour vos clients, c’est une catastrophe pour le diagnostic.
Si le back-office est accessible ? Allez dans Paramètres avancés → Performance → Mode debug → Oui. Enregistrez, rechargez la page blanche.
Si le back-office est aussi en page blanche ? Il faut passer par FTP :
- Connectez-vous avec FileZilla (ou équivalent)
- Ouvrez
config/defines.inc.php - Cherchez
define('_PS_MODE_DEV_', false); - Remplacez
falsepartrue - Enregistrez, rechargez
La page blanche devrait laisser place à un message d’erreur technique. Vous n’avez pas besoin de tout comprendre — repérez juste le mot-clé principal :
- Un nom de module → conflit de module
- « Allowed memory size » → mémoire PHP dépassée
- « deprecated » ou « Composer detected issues » → incompatibilité PHP
- « cache » ou un chemin
/var/cache/→ cache Symfony - « Access denied » → problème de connexion BDD
- « Smarty: unable to write file » → disque plein
Et si le debug est activé mais que la page reste blanche, sans aucune erreur ? Deux options :
- D’abord les logs serveur Apache ou Nginx — c’est le dernier endroit où l’erreur peut se cacher (demandez à votre hébergeur si vous ne savez pas où les trouver).
- Ensuite, vérifiez que votre hébergeur n’a pas bloqué les fonctions OPcache. Certains mutualisés désactivent
opcache_reset()pour des raisons de sécurité, et ça peut empêcher PrestaShop de tourner sans produire la moindre erreur visible. On a vu le cas plusieurs fois, et c’est documenté sur le GitHub PrestaShop.
Les 6 causes de page blanche PrestaShop
Grâce à ce mémo, vous couvrirez 99% des causes possible de votre page blanche. N’hésitez pas à nous appeler pour un dépannage en urgence de votre PrestaShop si vous préférez laisser un professionnel agir. Notre forfait à prix unique de 150 € HT sera rentabilisé en quelques heures au lieu de perdre du chiffre d’affaire.
1. Le cache Symfony corrompu
Le classique. Back-office blanc, front-office normal.
Symfony génère des fichiers de cache compilés pour accélérer le back-office. Quand ces fichiers se corrompent — mise à jour interrompue, pic de charge, ou parfois sans raison — plus rien ne s’affiche.
La solution, c’est par FTP : supprimez le contenu de /var/cache/prod/ et /var/cache/dev/. Pas les dossiers eux-mêmes, juste ce qu’il y a dedans. PrestaShop régénère tout au prochain chargement.
⚠️ Je répète : n’utilisez pas le bouton « Vider le cache » du back-office pour résoudre ce problème. Ce bouton peut lui-même déclencher une page blanche quand le cache est déjà corrompu. Passez par FTP et rien d’autre.
2. La mémoire PHP est trop basse
Page blanche sur les pages lourdes — grosses catégories, import CSV, régénération de miniatures. Le message debug dit « Allowed memory size exhausted ».
PrestaShop a besoin d’au moins 256 Mo de mémoire PHP. 512 Mo, c’est mieux dès que vous avez plus de 10 modules. Et pourtant, beaucoup de mutualisés sont encore configurés à 64 ou 128 Mo.
Augmentez le memory_limit dans votre php.ini ou via le panel de votre hébergeur. Si votre hébergeur ne vous laisse pas dépasser 128 Mo… c’est qu’il n’est pas fait pour PrestaShop. Et vous pouvez regarder nos offres d’hébergement PrestaShop si vous aimez la puissance !
3. L’hébergeur a mis à jour PHP sans vous prévenir
Page blanche soudaine, vous n’avez rien touché. Le debug affiche « deprecated », « Fatal error » ou « Composer detected issues ».
Depuis fin 2024, OVH, o2switch, Ionos, Hostinger (et d’autres) retirent progressivement PHP 7.4 et 8.0. Si votre PrestaShop ne supporte pas PHP 8.2+, c’est la page blanche immédiate. Et attention : ce n’est pas seulement le cœur de PrestaShop qui peut planter. Chaque module aussi. Il suffit d’un seul module avec une fonction dépréciée pour que tout tombe.
D’après ce qu’on observe chez nos clients, et c’est confirmé par d’autres sources spécialisées : environ 80 % des problèmes qui surviennent après une migration ou un changement de serveur sont liés à la version PHP. C’est énorme, mais logique.
Solution d’urgence : rétrogradez PHP dans le panel de votre hébergeur. Solution durable : planifiez une montée de version de PrestaShop. Consultez notre matrice de compatibilité PrestaShop/PHP sur l’article dédié aux erreurs 500.
4. Un module ou un thème qui casse tout
Page blanche apparue juste après une installation ou une mise à jour de module. Le diagnostic se fait par élimination :
- Le thème — Activez « classic ». Si ça revient, c’est le thème.
- Les surcharges — Paramètres avancés → Performance → « Désactiver toutes les surcharges ». C’est un outil de diagnostic que beaucoup de marchands ne connaissent pas. Si ça résout le problème, un override est en cause.
- Les modules un par un — Via FTP, renommez les dossiers de modules (
monmodule→monmodule_OFF). Commencez par le dernier installé. Rechargez après chaque renommage.
Au passage : ne supprimez jamais un module pour tester. Le renommage suffit et c’est réversible en 2 secondes. Supprimer sans passer par la désinstallation laisse des résidus en base de données.
5. Les permissions fichiers sont incorrectes
Après une migration FTP ou un changement de serveur. PrestaShop a besoin de dossiers en 755 et fichiers en 644. Certains clients FTP modifient les permissions pendant le transfert sans prévenir (oui, c’est vicieux).
Réinitialisez via SSH : find /chemin/prestashop -type d -exec chmod 755 {} \; et find /chemin/prestashop -type f -exec chmod 644 {} \;. Si vous n’avez pas accès SSH, le gestionnaire de fichiers de votre hébergeur peut souvent faire la même chose.
6. Le disque du serveur est plein
Le debug affiche « Smarty: unable to write file ». Quand le disque est saturé, PrestaShop ne peut plus écrire ses fichiers de cache ni compiler ses templates.
Les coupables habituels : logs qui s’accumulent, sauvegardes stockées sur le même serveur, ou les fameuses tables de statistiques PrestaShop qui gonflent la base de données.
Vérifiez l’espace disque dans votre panel hébergeur. Et si c’est la BDD qui déborde, allez voir la section dédiée dans notre guide sur PrestaShop lent — même mécanisme (tables ps_connections, ps_guest qui prennent des Go sans qu’on s’en rende compte).
Le piège : page blanche en production mais PrestaShop marche en mode debug
C’est le scénario le plus frustrant qu’on rencontre. Vous activez le debug : tout fonctionne, zéro erreur. Vous le coupez : page blanche. Aucun log ne montre rien.
On a vu ça des dizaines de fois. Le problème est documenté sur au moins 5 issues GitHub entre PS 1.7.5 et 1.7.8.
En mode debug, Symfony utilise /var/cache/dev/ — un cache qui se régénère à chaque chargement de page. En mode production, il utilise /var/cache/prod/ — un cache agressif qui ne bouge que quand on le vide explicitement.
Si le cache prod est corrompu, le site est blanc. Mais le debug, qui utilise un cache différent et propre, fonctionne sans problème.
La solution : supprimez tout le contenu de /var/cache/prod/ par FTP, puis repassez en production. PrestaShop régénère un cache propre.
Si ça revient régulièrement, c’est probablement un problème d’OPcache côté serveur. Ajoutez opcache.revalidate_freq=0 dans votre php.ini. L’impact performance est négligeable, la stabilité s’améliore sensiblement. On le met systématiquement chez nos clients qui ont eu ce souci plus d’une fois.
Page blanche PrestaShop après une migration ou un changement de domaine
Scénario spécifique mais qu’on croise de temps en temps. Vous migrez vers un nouveau serveur, vous changez de domaine, ou vous activez le SSL. Résultat : page blanche, ou pire, boucle de redirections infinie (ERR_TOO_MANY_REDIRECTS).
Le problème est presque toujours le même : PrestaShop stocke l’URL de votre boutique dans la base de données, à deux endroits. La table ps_shop_url (colonnes domain, domain_ssl, physical_uri) et la table ps_configuration (entrées PS_SHOP_DOMAIN et PS_SHOP_DOMAIN_SSL). Si ces valeurs pointent encore vers l’ancien domaine, PrestaShop essaie de rediriger vers une URL qui n’existe plus. Boucle. Page blanche.
Comment corriger : ouvrez phpMyAdmin, corrigez les URLs dans ces deux tables. Si vous venez d’activer le SSL, vérifiez que domain_ssl et PS_SHOP_DOMAIN_SSL sont bien renseignés (beaucoup de gens oublient celui-là). Puis supprimez le .htaccess à la racine — PrestaShop le régénérera depuis Paramètres de la boutique → Trafic & SEO.
Ah, et si après tout ça vous tombez sur ERR_TOO_MANY_REDIRECTS dans Chrome, c’est généralement que le .htaccess force le HTTPS mais que PrestaShop essaie de revenir en HTTP (ou l’inverse). Supprimez le .htaccess, laissez PrestaShop le recréer proprement, et ça devrait rentrer dans l’ordre.
Comment éviter que la page blanche se reproduise sur votre PrestaShop ?
- Gardez un
memory_limità 256 Mo minimum (512 Mo, c’est mieux). Vous pouvez vérifier la valeur actuelle dans le back-office : Paramètres avancés → Informations. - Fixez la version PHP chez votre hébergeur. Ne le laissez pas upgrader tout seul. Gérez les montées de version à votre rythme, après avoir vérifié la compatibilité de PrestaShop ET de vos modules.
- Testez chaque module en staging. Un module mal codé suffit à provoquer une page blanche sur tout le site. Si vous n’avez pas d’environnement de test, c’est le moment d’en mettre un en place, même basique.
- Surveillez l’espace disque. Les logs et sauvegardes s’accumulent. Prévoyez un nettoyage régulier ou une rotation automatique.
- Ayez des sauvegardes récentes. Si la page blanche apparaît juste après une action (mise à jour, module), restaurer une sauvegarde d’hier est souvent le chemin le plus rapide vers la remise en ligne. Plus rapide que le diagnostic, dans certains cas.
Et pour une vue d’ensemble sur les pannes PrestaShop, consultez notre service de dépannage PrestaShop ou le blog PrestaShop.
Votre boutique affiche une page blanche en ce moment ? On intervient 7j/7. Forfait dépannage à 150 €. Appelez nous directement au 09 72 03 59 17 — en général, on identifie la cause en moins de 30 minutes.
Et si vous en avez assez de découvrir les pannes en même temps que vos clients : le forfait maintenance CYBERIAL à 69 €/mois inclut la surveillance, les sauvegardes quotidiennes et l’intervention prioritaire.