L'« écran blanc de la mort » survient lorsque votre site WordPress affiche une page blanche vide sans aucun message d'erreur. C'est l'un des problèmes WordPress les plus frustrants, car il ne fournit aucun indice visible sur sa cause. Ce guide passe en revue les causes les plus courantes et explique comment résoudre chacune d'elles.
Étape 1 : Vérifier le journal des erreurs
La première chose à faire est de vérifier votre journal d'erreurs PHP, qui révèle généralement la cause exacte :
- Connectez-vous à KPanel sur kpanel.kapsulehost.com
- Allez dans Sites web, sélectionnez votre site, puis cliquez sur Journaux
- Ouvrez le Journal d'erreurs PHP
- Recherchez les entrées
Fatal errorproches du moment où l'écran blanc est apparu
Consultez Accéder aux journaux d'erreurs de votre site web pour plus de détails.
Étape 2 : Activer le mode débogage de WordPress
Si le journal des erreurs n'affiche pas assez de détails, activez le mode débogage de WordPress :
- Connectez-vous via SFTP ou le gestionnaire de fichiers de KPanel
- Ouvrez
wp-config.php - Définissez les éléments suivants :
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
- Rechargez la page et consultez
wp-content/debug.logpour le message d'erreur
Étape 3 : Désactiver toutes les extensions
Une extension défectueuse ou incompatible est la cause la plus fréquente d'un écran blanc après une mise à jour.
Si vous pouvez accéder à l'administration WordPress : allez dans Extensions > Extensions installées, sélectionnez-les toutes, puis choisissez Désactiver dans le menu des actions groupées.
Si vous ne pouvez pas accéder à l'administration WordPress :
- Connectez-vous à votre site via SFTP
- Accédez à
wp-content/plugins/ - Renommez le dossier
pluginsenplugins-disabled - Essayez de charger le site
Si l'écran blanc disparaît, une extension est en cause. Renommez le dossier en son nom d'origine plugins, puis désactivez les extensions une par une jusqu'à identifier celle qui pose problème.
Étape 4 : Passer à un thème par défaut
Un thème défectueux peut également provoquer un écran blanc :
- Via SFTP, accédez à
wp-content/themes/ - Renommez le dossier de votre thème actif en quelque chose comme
mytheme-disabled - WordPress basculera alors vers un thème par défaut
Après avoir identifié l'extension ou le thème problématique, vérifiez si une mise à jour est disponible auprès du développeur. De nombreux problèmes d'écran blanc sont corrigés dans la version suivante.
Étape 5 : Augmenter la limite de mémoire PHP
Un écran blanc peut survenir lorsque WordPress manque de mémoire. Pour augmenter la limite :
- Ouvrez
wp-config.phpdans le gestionnaire de fichiers ou via SFTP - Ajoutez cette ligne avant la ligne
/* That's all, stop editing! */:
define( 'WP_MEMORY_LIMIT', '256M' );
- Enregistrez le fichier et rechargez le site
Vous pouvez également augmenter la limite de mémoire PHP dans KPanel, sous Sites web > [votre site] > Paramètres > PHP.
Étape 6 : Restaurer à partir d'une sauvegarde
Si aucune des étapes précédentes ne résout le problème, restaurer une sauvegarde effectuée avant l'apparition du problème est le moyen le plus rapide d'y remédier. Consultez Restaurer à partir d'une sauvegarde.
Toujours pas résolu ?
Si l'écran blanc persiste après avoir suivi ces étapes, ouvrez un ticket d'assistance dans KPanel, sous Assistance. Joignez les entrées les plus récentes du journal d'erreurs PHP ainsi qu'une description de ce qui a changé sur le site avant l'apparition du problème.