Vous êtes confronté à l’affichage d’un écran blanc dans WordPress ?
Comment faire pour résoudre ça !
Un écran blanc dans WordPress est un problème courant et peut avoir différentes causes.
Voyons ensemble comment résoudre ce problème. L’erreur (ou plutôt les erreurs) de l’écran blanc dans WordPress est vraiment très ennuyeuse, elle ne vous donnera pas le moindre message d’erreur ou information utile quant à la cause du problème.
Une seule chose est sûre : quelque chose ne va pas ! Mais quoi ?
Qu’est-ce que « l’écran blanc de la mort » ?
Certains soucis dans WordPress provoquent un écran blanc (dit « de la mort ») dans votre navigateur web. L’écran blanc de la mort (ou White Screen of Death) est une erreur des plus courantes dans WordPress. Particulièrement frustrante dans le fait quelle ne vous donne aucune information ni message d’erreur quant à sa provenance et peut même, dans de nombreux cas, vous bloquer l’accès à l’administration WordPress du site.
Lorsqu’un site WordPress affiche cet WSOD (l’écran blanc), ce qui est sûr c’est qu’une erreur est derrière. La bonne nouvelle c’est qu’il s’agit d’un problème relativement courant dans WordPress est donc relativement connu des utilisateurs.
Une erreur connue dans la communauté
Heureusement c’est un problème connu de la communauté WordPress. Le problème de « l’écran blanc de la mort » est mentionné dans le Codex WordPress, le guide officiel de la communauté WP. Parmi les erreurs listées dans cet article, celui de l’écran blanc est affiché en première position de la liste, avec ce titre terrifiant d’écran blanc de la mort. C’est d’ailleurs plutôt rassurant de voir qu’il s’agit d’une erreur bien connue ; et vous retrouverez dans cette page certaines des causes possibles du problème en question.
Causes et solutions pour l’écran blanc de WordPress
Un problème d’écran blanc WordPress peut avoir différentes causes, en voici quelques une et leur solution.
Avant d’apporter des modifications à votre site vérifiez tout d’abord si le problème se pose également sur d’autres sites (si vous en gérez plusieurs) ; il peut s’avérer que cela ne soit pas spécifique à un nom de domaine en particulier. Il pourra alors s’agir d’une erreur du fournisseur de services Internet ou de votre service d’hébergement web. Mais généralement ce n’est pas le cas.
Attention : rappel élémentaire dans WordPress, faites une sauvegarde de votre site avant d’effectuer tout changement (ou assurez-vous d’en avoir déjà une sous le coude).
Une extension pour cause
De part mon expérience, c’est assez souvent une extension (plugin) qui provoque ce genre de souci. Vérifiez si l’un de vos plug-ins en est la cause. Pour se faire, désactivez TOUTES vos extensions WordPress de votre site. Remarquez ensuite si votre site est de nouveau accessible suite à la désactivation. Si c’est bien le cas, réactivez ensuite vos extensions une à une jusqu’à ce que le problème resurgisse, ainsi vous aurez identifier celle qui ne va pas.
Néanmoins, si le souci persiste après la réactivations des extensions, il est temps de chercher ailleurs.
Une erreur du à votre thème WordPress
Peut-être est-ce votre thème WordPress qui est obsolète ou bien mal développé. Beaucoup de thèmes gratuits, surtout pour ceux qui ne font pas parti du référentiel de WordPress.org, ne sont pas forcément fiables. C’est pourquoi il convient de bien sélectionné son thème. Les thèmes premium sont généralement plus stables à ce niveau là (mais attention ce n’est pas toujours le cas).
Activez pour cela un thème officiel de WordPress, Twenty Twenty-Five par exemple, pour savoir si le problème provient de votre thème. Si vous n’avez plus accès à votre espace d’administration WordPress vous pouvez procéder directement par FTP en accédant au dossier /wp-content/themes/. Assurez-vous que le thème Twenty Twenty-Five est présent dans ce dossier themes, puis renommer celui qui est actuellement actif sur votre site (ajoutez tout simplement 0 avant par exemple), cela le désactivera et forcera WordPress à rechercher un thème standard à activer (Twenty Twenty-Five).
Si le problème s’est résolu en désactivant votre thème, vous pouvez essayer de corriger l’erreur en consultant son fichier functions.php (présent généralement directement dans le dossier du thème). Parfois cela peut provenir d’une erreur de syntaxe, un espaces en trop, ou une ligne mal codée. Bien sûr il faut faire appel ici à quelques connaissances techniques, sinon, il vous faudra l’aide d’un développeur pour examiner ça.
Sinon, vous pouvez également essayer en réinstallant la dernière version de votre thème. Attention cependant à ce qu’il n’y ait pas eu de modifications dans ce thème, sinon elles seront toutes écrasées (à moins que vous n’utilisez correctement un thème enfant.
Éditeur de site (FSE)
Si vous utilisez un thème basé sur les blocs en édition complète de site (FSE – Full Site Editing), essayez temporairement de revenir à un thème classique avant le FSE, comme Twenty Twenty-Three, pour voir si le problème persiste.
Votre site dépasse la limite de mémoire PHP
Parfois, votre site peut dépasser la limite de mémoire par défaut de WordPress. Vous pouvez augmenter la limite de mémoire PHP pour essayer de résoudre ce problème. Le dépassement de cette limite peut avoir différentes causes, par exemple un thème ou un plugin gourmand en ressource ou mal codé, ou encore un serveur d’hébergement mal configuré : vous pouvez contacter votre hébergeur pour plus d’information, Ils pourront consulter les fichiers « journaux » (logs) pour voir ce qui est à l’origine du problème.
Pour augmenter cette limite nous pouvons ajouter la ligne suivante au fichier de configuration wp-config.php de WordPress. Cela nécessite aussi un client FTP (File Transfer Protocol) comme FileZilla (pour le plus connu) ou via la gestion de fichiers dans le cPanel de votre hébergeur si celui-ci en propose un (je sais ça devient un peu plus compliqué, mais c’est l’informatique…) :
define('WP_MEMORY_LIMIT', '128M');
De cette manière, la limite de mémoire PHP sera augmentée à 128 Mo. Une fois les modifications apportées, le site pourrait fonctionner de nouveau. Il se peut que votre service d’hébergement ne permette pas de modifier certains paramètres tel que la limite de mémoire (n’hésitez pas à leur demander).
Compatibilité PHP
Pensez à vérifier sur votre hébergeur la version de PHP activée.
Actuellement (et idéalement) vous devriez être sur PHP 8.0 ou 8.2 pour WordPress, mais certaines extensions ou thèmes anciens peuvent causer des erreurs avec ces nouvelles versions.
Si vous rencontrez un écran blanc après une mise à jour vers PHP 8.x, envisagez de revenir temporairement à une version antérieure de PHP (comme 7.4). Certaines extensions devraient pouvoir supporter une version plus récente de PHP une fois mis à jour par leurs développeurs.
Un problème de cache ?
Si vous utilisez une extension pour gérer la mise en cache du site (telle que WP Super Cache, WP Rocket, W3 Total Cache, LiteSpeed Cache), il peut arriver que ce cache provoque l’écran blanc.
Pour vérifier si c’est le cas, consultez votre site en ouvrant une nouvelle fenêtre en mode navigation privée et regardez si l’écran blanc s’affiche toujours. Videz également le cache/l’historique de votre navigateur pour voir si votre site ne fonctionne pas après ça.
De manière générale, surtout pour les sites simples (blog, sites vitrines), je vous déconseille d’utiliser un système de cache. Votre site devrait être rapide même sans cela.
Et sinon… ?
Si les solutions ci-dessus n’offrent pas de solution, vous pouvez toujours effectuer une nouvelle installation de WordPress.
Activer le mode de débogage
Une autre option consiste à activer le mode débogage.
Pour cela ouvrez le fichier wp-config.php et ajoutez la ligne de code suivante :
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true); // Écrit les erreurs dans wp-content/debug.log
define('WP_DEBUG_DISPLAY', false); // Empêche les erreurs de s’afficher publiquement
@ini_set('display_errors', 0); // sécurité supplémentaire
Au lieu d’un simple écran blanc, des erreurs apparaîtront pouvant alors vous donner des indications pour trouver le fichier responsable de la panne.
C’est vraiment fort utile. Vous pouvez d’ailleurs commencer par ça. Il vous suffira de retirer ces lignes une fois terminé.
Outils de récupération intégrés (depuis WordPress 5.2)
Depuis WordPress 5.2, lorsqu’une erreur critique (comme cet écran blanc) survient, WordPress envoie parfois automatiquement un email à l’administrateur du site avec un lien spécial pour accéder au mode récupération.
Vérifiez alors votre boîte de messagerie administrateur, vous pourriez avoir reçu un message facilitant l’accès à votre tableau de bord pour corriger le problème.
La conclusion de la mort
L’écran blanc est un problème pénible mais assez bien connu qui ne devrait pas vous laissé sans solution dans 99% des cas (je pense). Jusqu’à ce que ce problème soit complètement éliminé ces solutions peuvent encore être essayées.
Parfois, il arrive que ce genre de problème soit difficile à éviter, notamment lorsqu’il s’agit d’un site comportant pas mal de ressources (extensions, personnalisations, code…). Pour résoudre cela tenez compte des conseils ci-dessus et de tous ceux que vous pourrez trouver sur le net afin de les éviter, sinon de les réduire. Il peut également être utile de contacter votre hébergeur qui pourrait rapidement découvrir ce qui ne va pas en consultant les fichiers journaux de votre serveur.
Et si c’est toujours la panique de votre côté vous pouvez encore me poser vos questions dans les commentaires ci-dessous !