WordPress n'affiche qu'une page blanche

WordPress n'affiche qu'une page blanche : comment corriger l'Écran Blanc de la Mort

Vous vous rendez sur votre site WordPress et vous ne voyez qu'une page blanche et vide ? Pas de message d'erreur, pas de tableau de bord, pas de contenu ? Ce problème est communément appelé l'Écran Blanc de la Mort (White Screen of Death), ou WSoD en abrégé.

Aussi dramatique que le nom puisse paraître : dans la plupart des cas, vos contenus, images et réglages ne sont pas perdus. Le plus souvent, le site est bloqué par une erreur PHP, un plugin défectueux, un thème corrompu, un problème de limite de mémoire ou un conflit après une mise à jour. Une recherche méthodique des erreurs permet généralement de bien cibler la cause.

Qu'est-ce que l'Écran Blanc de la Mort ?

L'Écran Blanc de la Mort décrit une situation dans laquelle WordPress ne génère plus aucun affichage visible. Au lieu du site ou du tableau de bord, seule une page vide apparaît. Selon la configuration du serveur, un message tel que « Il y a eu une erreur critique sur votre site » peut également s'afficher.

Symptômes typiques :

• La page d'accueil reste blanche,
• Le tableau de bord ne se charge plus,
• Seules certaines sous-pages restent blanches,
• La connexion fonctionne, mais une page vide apparaît juste après,
• Le site est inaccessible après la mise à jour d'un plugin,
• Le site est vide après un changement de thème,
• Une erreur PHP s'affiche à la place du site,
• L'erreur se produit uniquement dans le backend ou uniquement dans le frontend.

La cause peut souvent être identifiée selon que seul le site public, seul le tableau de bord ou les deux sont touchés.

Causes fréquentes

1. Vérifiez votre boîte de réception e-mail

WordPress dispose d'un mode de protection intégré contre les erreurs fatales. Lorsqu'une erreur critique survient, WordPress envoie souvent un e-mail à l'adresse de l'administrateur du site.

Cet e-mail peut contenir :

• Une indication sur le plugin ou le thème défectueux,
• Un message d'erreur technique,
• Un lien vers le mode de récupération,
• Des informations sur le fichier concerné,
• Des conseils pour résoudre le problème.

Pensez également à vérifier le dossier des courriers indésirables (Spam). Si la configuration de l'envoi d'e-mails de votre site via SMTP n'est pas correcte, ce message peut toutefois être manquant.

2. Utiliser le mode de récupération

Si WordPress vous envoie un lien vers le mode de récupération, vous devriez l'utiliser en priorité. Le mode de récupération permet souvent d'accéder au tableau de bord alors même qu'un plugin ou un thème provoque une erreur.

En mode de récupération, vous pouvez :

• Désactiver le plugin défectueux,
• Vérifier le thème actif,
• Effectuer des mises à jour,
• Examiner les erreurs critiques de plus près,
• Rendre votre site à nouveau accessible.

Si aucun lien de récupération n'est disponible, passez aux étapes suivantes.

3. Activer le mode de débogage (Debug)

WordPress masque souvent les erreurs PHP pour des raisons de sécurité. C'est pourquoi vous ne voyez qu'une page vide. Avec le mode de débogage, vous pouvez rendre visibles les indices sur la cause ou les inscrire dans un fichier journal (log).

Comment activer le mode de débogage via cPanel :

1. Connectez-vous à votre cPanel.
2. Ouvrez le Gestionnaire de fichiers.
3. Naviguez vers le répertoire principal de votre installation WordPress.
4. Ouvrez le fichier wp-config.php.
5. Recherchez la ligne define( 'WP_DEBUG', false );.
6. Modifiez-la prudemment en define( 'WP_DEBUG', true );.
7. Enregistrez le fichier.
8. Actualisez le site internet.

Si la ligne n'existe pas, vous pouvez l'insérer juste au-dessus de la ligne qui indique la fin de l'édition et le chargement de WordPress.

4. Meilleure configuration de débogage : enregistrer les erreurs plutôt que de les afficher

Sur les sites en production, il est préférable de ne pas afficher les erreurs publiquement, mais de les faire écrire dans un fichier journal. Pour cela, vous pouvez utiliser les valeurs suivantes dans le fichier wp-config.php :

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

Les erreurs sont alors fréquemment enregistrées dans le fichier suivant :

wp-content/debug.log

Après l'analyse, vous devriez désactiver à nouveau le débogage ou au moins vous assurer que le fichier journal n'est pas accessible au public.

5. Bien lire les messages d'erreur

Les messages d'erreur semblent compliqués au premier abord. Pourtant, le message contient généralement une indication essentielle : le chemin d'accès au fichier concerné.

Exemple :

Fatal error: Uncaught Error in /home/user/public_html/wp-content/plugins/beispiel-plugin/plugin.php on line 123

Ici, le chemin pointe vers :

wp-content/plugins/beispiel-plugin/

Cela signifie : Il est très probable que ce plugin soit à l'origine de l'erreur. Si le chemin pointe vers wp-content/themes/, la cause se situe plutôt au niveau du thème.

6. Désactiver tous les plugins pour test

Si vous n'avez pas d'indice précis, un conflit de plugins est souvent la cause la plus probable. Vous pouvez désactiver tous les plugins depuis l'extérieur, sans utiliser le tableau de bord.

Comment procéder via le Gestionnaire de fichiers cPanel :

1. Dans cPanel, ouvrez le Gestionnaire de fichiers.
2. Naviguez jusqu'au dossier wp-content.
3. Recherchez le dossier plugins.
4. Renommez-le en plugins_old.
5. Retournez sur votre site internet.

Si le site se charge à nouveau après cela, l'un des plugins était très probablement le déclencheur.

Renommez ensuite le dossier pour qu'il s'appelle à nouveau plugins. Dans le tableau de bord de WordPress, vous pourrez alors activer les plugins un par un jusqu'à ce que l'erreur se reproduise.

7. Désactiver un plugin spécifique

Si le message d'erreur pointe déjà vers un plugin spécifique, vous n'avez pas besoin de désactiver tous les plugins.

1. Ouvrez wp-content/plugins/.
2. Recherchez le dossier du plugin concerné.
3. Renommez-le, par exemple de nomduplugin en nomduplugin_desactive.
4. Vérifiez à nouveau le site internet.

Si le site fonctionne à nouveau, vérifiez si une mise à jour est disponible ou si vous devez trouver une alternative à ce plugin.

8. Vérifier si le thème est en cause

Si l'erreur survient après la mise à jour d'un thème, un changement de thème ou une modification dans functions.php, la cause est probablement liée au thème.

Procédure :

1. Ouvrez le dossier wp-content/themes/.
2. Recherchez le dossier de votre thème actif.
3. Renommez temporairement ce dossier.
4. WordPress essaiera alors de basculer sur un thème par défaut disponible.

Pour que cela fonctionne, un thème par défaut récent comme Twenty Twenty-Four, Twenty Twenty-Five ou un autre thème par défaut de WordPress doit être installé.

9. Annuler une erreur dans le fichier functions.php

Si vous avez inséré du code dans le fichier functions.php juste avant l'apparition de l'erreur, supprimez d'abord cette modification.

Causes typiques :

• Point-virgule manquant,
• Fonction définie deux fois,
• Parenthèse incorrecte,
• Code PHP au mauvais endroit,
• Extrait de code provenant d'une source non sécurisée,
• Code prévu pour une autre version de WordPress.

Ouvrez le fichier via cPanel ou FTP et supprimez le dernier code inséré. Enregistrez le fichier et testez à nouveau le site.

10. Vérifier la limite de mémoire PHP (PHP Memory Limit)

Si WordPress, WooCommerce, un constructeur de pages ou un processus de sauvegarde nécessite plus de mémoire que ce qui est autorisé, une erreur fatale (Fatal Error) peut survenir. On voit alors souvent des mentions de type « Allowed memory size exhausted ».

Exemple :

Fatal error: Allowed memory size of 134217728 bytes exhausted

Solutions possibles :

• Vérifier la limite de mémoire PHP dans cPanel,
• Passer à une version récente de PHP,
• Vérifier les plugins gourmands en ressources,
• Optimiser la configuration du constructeur de pages ou de WooCommerce,
• Vérifier les ressources d'hébergement en cas de problèmes récurrents.

N'augmentez pas les limites aveuglément sans analyser la cause. Si un plugin consomme une quantité anormale de mémoire, il convient de l'examiner de plus près.

11. Vérifier la version de PHP

Un changement de version de PHP peut déclencher des erreurs si un ancien plugin ou thème n'est pas compatible. À l'inverse, une version très ancienne de PHP peut également causer des problèmes.

Vérifiez dans cPanel :

• Quelle version de PHP est active ?
• La version est-elle compatible avec WordPress ?
• Les plugins et le thème sont-ils compatibles avec cette version de PHP ?
• L'erreur est-elle apparue après un changement de version PHP ?

Si l'erreur a commencé directement après un changement de PHP, vous pouvez tester un retour à la version précédente, puis mettre à jour ou remplacer les plugins concernés.

12. Régénérer le fichier .htaccess

Un fichier .htaccess corrompu entraîne plus souvent des erreurs de redirection ou des erreurs 500, mais il peut également bloquer un site internet.

Comment tester prudemment :

1. Ouvrez le Gestionnaire de fichiers.
2. Dans le répertoire principal de WordPress, recherchez le fichier .htaccess.
3. Renommez-le, par exemple en .htaccess_old.
4. Retournez sur le site internet.
5. Si vous accédez à nouveau au tableau de bord, allez dans Réglages > Permaliens.
6. Cliquez sur Enregistrer les modifications sans rien modifier.

WordPress générera ainsi un nouveau fichier .htaccess par défaut, à condition que les droits du fichier le permettent.

13. Vider le cache

Parfois, la cause réelle a déjà été corrigée, mais un cache continue de distribuer une page erronée ou vide.

Videz le :

• Cache WordPress,
• Plugin de mise en cache,
• Cache du serveur, s'il est actif,
• Cache CDN, si vous en utilisez un,
• Cache du navigateur.

Testez également le site internet dans une fenêtre de navigation privée.

14. Vérifier les journaux d'erreurs (Error Logs) dans cPanel

Les journaux du serveur sont souvent le moyen le plus rapide de trouver la cause. Ils affichent les erreurs PHP, les chemins de fichiers et les horodatages.

Faites attention à :

• Fatal error,
• Parse error,
• Allowed memory size exhausted,
• Call to undefined function,
• Cannot redeclare function,
• Chemins vers wp-content/plugins/,
• Chemins vers wp-content/themes/.

Si vous ne parvenez pas à interpréter le message, copiez-le dans un ticket de support. Le chemin vers le fichier concerné est généralement le plus important.

15. Si seul le tableau de bord est blanc

Si le site public fonctionne mais que le tableau de bord reste blanc, la cause est souvent liée à un plugin spécifique à l'administration, un widget de tableau de bord, un plugin de sécurité, un constructeur de pages ou un problème de mémoire dans le backend.

Vérifiez en particulier :

• Les plugins de sécurité,
• Les plugins SEO avec des widgets de tableau de bord,
• Les plugins de statistiques,
• L'administration de WooCommerce,
• Les constructeurs de pages,
• La limite de mémoire PHP,
• La console du navigateur.

16. Si seules certaines pages sont blanches

Si une seule page spécifique est touchée, la cause peut provenir d'un bloc particulier, d'un shortcode, d'un modèle (template) ou d'un élément de constructeur de pages.

Causes possibles :

• Shortcode défectueux,
• Modèle de constructeur de pages corrompu,
• Code PHP dans un widget,
• Intégration incorrecte,
• Galerie trop volumineuse,
• Problème de produit WooCommerce,
• Fonction de plugin active uniquement sur cette page.

Dans ce cas, vous devriez d'abord vérifier la page concernée, le modèle utilisé et les plugins qui y sont activés.

17. Ce que vous ne devez pas faire

• Supprimer des fichiers WordPress au hasard.
• Modifier la base de données sans sauvegarde préalable.
• Supprimer tous les plugins au lieu de les renommer.
• Laisser le mode de débogage actif publiquement de manière permanente.
• Modifier directement les fichiers du thème sans copie de sauvegarde.
• Écraser les sauvegardes avant de connaître la cause du problème.
• Installer des plugins de réparation inconnus provenant de sources non fiables.
• Remettre une boutique WooCommerce en ligne sans test préalable.

18. Après la réparation : tester entièrement le site

Une fois que le site se charge à nouveau, vous ne devriez pas vous arrêter là. Vérifiez que toutes les fonctions importantes fonctionnent à nouveau correctement.

Testez :

• La page d'accueil,
• La page de contact,
• Les formulaires,
• La connexion,
• Le tableau de bord,
• Les menus,
• L'affichage mobile,
• Le panier et la commande WooCommerce, si présents,
• Le plugin SEO,
• La mise en cache,
• Les journaux d'erreurs pour voir si de nouveaux messages apparaissent.

Si un plugin était la cause du problème, vérifiez si une mise à jour, une alternative ou un changement de configuration est nécessaire.

19. Prévention contre les problèmes d'écran blanc

De nombreux problèmes d'écran blanc peuvent être évités grâce à une bonne maintenance.

• Effectuer les mises à jour régulièrement,
• Créer une sauvegarde avant chaque mise à jour,
• Utiliser un site de staging pour les sites importants,
• Utiliser uniquement des plugins bien maintenus,
• Supprimer les plugins et thèmes inutilisés,
• Utiliser un thème enfant (Child Theme) pour les modifications de code,
• Maintenir la version de PHP à jour,
• Vérifier les conflits de plugins après les mises à jour,
• Stocker les sauvegardes en externe,
• Contrôler les journaux d'erreurs en cas d'anomalie.

Ordre de dépannage recommandé

1. Vérifier l'e-mail d'admin : Y a-t-il un lien de récupération ?
2. Vérifier la sauvegarde : Existe-t-il une sauvegarde récente ?
3. Activer le journal de debug : Rendre les erreurs visibles ou les enregistrer.
4. Lire le message d'erreur : Identifier le chemin du plugin ou du thème.
5. Désactiver les plugins : Renommer un plugin spécifique ou tout le dossier des plugins.
6. Vérifier le thème : Désactiver le thème actif pour test.
7. Vérifier la limite de mémoire PHP : Surtout en cas d'erreurs de mémoire.
8. Vérifier la version de PHP : Exclure un problème de compatibilité.
9. Vérifier le fichier .htaccess : En cas d'erreurs de serveur ou de redirection.
10. Vérifier le cache : Supprimer l'affichage de l'ancienne erreur.
11. Tester le site : Vérifier le frontend, le backend, les formulaires et la boutique.
12. Désactiver à nouveau le debug : Ne plus afficher de messages d'erreur publiquement.

Questions fréquentes sur l'Écran Blanc de la Mort

Mes contenus sont-ils perdus ?

Dans la plupart des cas, non. L'écran blanc signifie simplement que WordPress ne peut pas se charger en raison d'une erreur. Les contenus et la base de données sont souvent toujours bien présents.

Quelle est la cause la plus fréquente ?

Les conflits de plugins, les mises à jour défectueuses, les problèmes de thème ou les erreurs PHP dans les personnalisations de code individuelles sont très fréquents.

Pourquoi ne vois-je aucun message d'erreur ?

Les messages d'erreur sont souvent masqués pour des raisons de sécurité. Activez la journalisation du débogage pour obtenir des indices.

Puis-je désactiver des plugins sans accéder au tableau de bord ?

Oui. Renommez le dossier wp-content/plugins ou le dossier d'un plugin individuel via cPanel ou FTP.

Que faire de WP_DEBUG après le dépannage ?

Remettez WP_DEBUG sur false ou désactivez les affichages publics de débogage. Le débogage ne doit pas rester visible en permanence sur un site en production.

Un thème peut-il causer l'écran blanc ?

Oui. Un thème peut en être la cause, en particulier après des mises à jour de thèmes, des modifications apportées au fichier functions.php ou en raison de modèles incompatibles.

Que signifie « Allowed memory size exhausted » ?

WordPress ou un plugin nécessite plus de mémoire PHP que ce qui est disponible. Vérifiez la limite de mémoire (Memory Limit), les plugins et les ressources du serveur.

Quand dois-je contacter le support ?

Si vous ne parvenez pas à interpréter le message d'erreur, si vous n'avez pas accès aux fichiers, si une boutique WooCommerce est touchée ou si le site ne fonctionne pas malgré le test des plugins/thèmes.