Résoudre le problème de l'écran blanc WordPress

The "white screen of death" is when your WordPress site displays a blank white page with no error message. It is one of the more frustrating WordPress issues because it gives no visible clue about…

L'« écran blanc de la mort » se produit lorsque votre site WordPress affiche une page blanche vide sans message d'erreur. C'est l'un des problèmes WordPress les plus frustrants car il ne donne aucun indice visible sur la cause. Ce guide parcourt les causes les plus courantes et comment corriger chacune d'entre elles.

Étape 1 : Vérifier le journal des erreurs

La première chose à faire est de vérifier votre journal des erreurs PHP, qui révèle généralement la cause exacte :

Connectez-vous à KPanel à l'adresse kpanel.kapsulehost.com
Allez à Websites (Sites Web), sélectionnez votre site et cliquez sur Logs (Journaux)
Ouvrez le PHP Error Log (Journal des erreurs PHP)
Recherchez les entrées Fatal error près du moment où l'écran blanc a commencé

Voir Accessing Your Website Error Logs 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 paramètres suivants :

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Rechargez la page et vérifiez wp-content/debug.log pour voir le message d'erreur

Étape 3 : Désactiver tous les plugins

Un plugin défectueux ou incompatible est la cause la plus courante d'un écran blanc après une mise à jour.

Si vous pouvez accéder à l'administration de WordPress : allez à Plugins > Installed Plugins (Plugins > Plugins installés), sélectionnez tous les éléments et choisissez Deactivate (Désactiver) dans le menu des actions groupées.

Si vous ne pouvez pas accéder à l'administration de WordPress :

Connectez-vous à votre site via SFTP
Accédez à wp-content/plugins/
Renommez le dossier plugins en plugins-disabled
Essayez de charger le site

Si l'écran blanc disparaît, un plugin est le coupable. Renommez le dossier en plugins, puis désactivez les plugins un à un jusqu'à identifier le plugin problématique.

Étape 4 : Basculer vers un thème par défaut

Un thème cassé peut également causer un écran blanc :

Via SFTP, allez à wp-content/themes/
Renommez le dossier de votre thème actif en quelque chose comme mytheme-disabled
WordPress reviendra à un thème par défaut

Après avoir identifié le plugin 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 se produire lorsque WordPress manque de mémoire. Pour augmenter la limite :

Ouvrez wp-config.php dans 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 Websites > [votre site] > PHP Settings (Sites Web > [votre site] > Paramètres PHP).

Étape 6 : Restaurer à partir d'une sauvegarde

Si aucune des étapes ci-dessus ne résout le problème, la restauration à partir d'une sauvegarde effectuée avant que le problème n'apparaisse est le chemin le plus rapide vers la résolution. Voir Restoring From Backup.

Toujours pas résolu ?

Si l'écran blanc persiste après avoir suivi ces étapes, ouvrez un ticket d'assistance dans KPanel sous Support. Incluez les entrées du journal des erreurs PHP les plus récentes et une description de ce qui a changé sur le site avant que le problème n'apparaisse.