Page blanche : le site répond mais n’affiche rien
Une page blanche est le contraire d’une absence d’information : le serveur a répondu, le programme s’est exécuté puis s’est arrêté net, et le message qui explique pourquoi a été écrit quelque part — simplement pas à l’écran. Tant qu’on ne l’a pas lu, tout ce qu’on tente est une supposition.
Pourquoi l’écran reste vide
Par défaut, un site en production est configuré pour ne jamais montrer ses erreurs aux visiteurs : afficher un chemin de fichier ou un identifiant de base de données serait une faille. Quand une erreur fatale survient, le programme s’interrompt, la page est envoyée telle qu’elle était à cet instant — c’est-à-dire vide — et le détail part dans un journal.
Il existe deux familles de pages blanches. Celle où le code source de la page est réellement vide : l’exécution s’est arrêtée avant d’écrire quoi que ce soit, en général une erreur fatale de PHP ou un dépassement de mémoire. Et celle où le code source contient bien du HTML mais rien de visible : là, le programme a fonctionné, c’est l’affichage qui est cassé — feuille de style non chargée, gabarit vide, ou script qui masque le contenu.
Retrouver le message caché
-
Afficher le code source de la page
Un clic droit puis « afficher le code source ». Si la fenêtre est vide, c’est une erreur fatale. S’il y a du HTML, c’est un problème d’affichage. Cette seule observation divise le champ des causes par deux.
-
Ouvrir le journal d’erreurs du serveur
Chez la plupart des hébergeurs, il est accessible depuis le panneau d’administration. La ligne datée de votre dernier essai contient le fichier et la ligne exacte qui a échoué.
-
Activer temporairement le mode de débogage
Il fait réapparaître le message à l’écran. Il ne s’active que le temps du diagnostic : laissé actif, il expose des informations internes à tous les visiteurs.
-
Noter la portée
Tout le site, une seule page, ou seulement l’administration ? Une page blanche limitée à l’administration désigne presque toujours un module ; une page blanche générale désigne le cœur ou le serveur.
-
Rapprocher de la dernière intervention
Mise à jour, installation, modification d’un fichier de thème : la page blanche suit presque toujours une action, même faite par quelqu’un d’autre.
Ce que je trouve le plus souvent derrière
- Une limite de mémoire PHP atteinte sur une page lourde : catalogue volumineux, export, page d’administration listant beaucoup d’enregistrements.
- Un module ou une extension incompatible avec la version de PHP en place depuis un changement chez l’hébergeur.
- Une modification directe dans un fichier de thème, avec une erreur de syntaxe : une accolade ou un point-virgule manquant suffit.
- Un cache compilé resté en place après une mise à jour, qui référence des fichiers qui n’existent plus.
Continuer sur la bonne page
-
Activer le mode debug sur PrestaShop
La marche à suivre exacte pour faire réapparaître le message d’erreur.
-
Activer le mode debug sur WordPress
L’équivalent côté WordPress, et où le journal est écrit.
-
Lire les journaux d’erreurs PrestaShop
Comment lire une trace d’erreur sans être développeur.
-
Le mode debug expliqué
Ce qu’il affiche, et pourquoi il ne doit jamais rester actif en production.
Décrivez votre besoin en 1 minute
Quelques questions ciblées pour que je vous réponde avec une estimation, pas avec un questionnaire de plus.