Rien n’est pire que de naviguer sur votre site WordPress et d’être soudainement confronté à l’écran blanc de la mort, le rendant inaccessible aux administrateurs et aux visiteurs. Aujourd’hui, nous allons vous présenter six problèmes courants qui surviennent avec l’écran blanc de la mort WordPress, les causes les plus fréquentes et surtout, les solutions pour le résoudre afin que vous puissiez remettre votre site en marche aussi vite que possible.

Écran blanc de la mort WordPress ? 😱 Pas besoin de paniquer, voici comment le réparer rapidemen Cliquez pour Tweet

Écran blanc de la mort WordPress

Un écran blanc de mort WordPress (White Screen Of Death – WSOD) est presque toujours causé par des erreurs de code PHP ou un épuisement de la mémoire. La première chose à faire est de déterminer si l’administration de votre site fonctionne ou non. Si le front-end du site est en panne, mais que l’admin fonctionne, il y a des chances que vous ayez un thème ou un plugin défectueux. Vous pouvez vérifier votre administrateur en naviguant simplement sur votredomaine.com/wp-admin.

Un écran blanc de mort peut aussi sembler légèrement différent selon le navigateur. Voici un exemple dans Google Chrome. Il nous donne en fait un avertissement disant « Cette page ne fonctionne pas et ne peut pas traiter la demande ». C’est une erreur HTTP 500.

Toujours à la recherche de cet hébergeur WordPress parfait ?

Essayez l'hébergement WordPress Premium de Kinsta pour découvrir votre site sans problèmes.
  • Contrôles stylisés représentant la gestion Entièrement infogéré
  • Bouclier avec une tique représentant la sécuritéSécurisé comme le fort knox
  • Fusionner des lignes représentant des migrationsMigrations gratuites
  • Trois chevrons droits représentant la vitesse du serveurVitesse ultime
  • Flèche circulaire avec un point central représentant les sauvegardesSauvegardes quotidiennes
  • Hexagones décalés représentant notre pile de serveursPlatforme Google Cloud
Écran blanc de la mort WordPress dans Google Chrome

Écran blanc de la mort WordPress dans Google Chrome

Dans Mozilla Firefox, c’est juste un écran complètement blanc, sans erreurs ni avertissements.

Écran blanc de la mort WordPress dans Mozilla Firefox

Écran blanc de la mort WordPress dans Mozilla Firefox

Comment réparer un problème de WSOD

Si vous voyez un écran comme ci-dessus, voici quelques étapes courantes pour résoudre le problème :

  1. Désactiver les plugins et les thèmes
  2. Résoudre les erreurs de syntaxe
  3. Activer le débogage
  4. Augmenter les limites de mémoire
  5. Problèmes d’autorisation des fichiers de vérification
  6. Vérifier l’échec de la mise à jour automatique

1. Désactiver les plugins et les thèmes

L’un des moyens les plus simples et les plus courants de corriger l’écran blanc de mort de WordPress est de simplement désactiver tous vos plugins. Il arrive souvent qu’un site tombe en panne à cause d’une mauvaise mise à jour de plugin. Si vous pouvez toujours accéder à votre admin, un moyen rapide de le faire est de naviguer vers « Extnsions » et de sélectionner « Désactiver » dans le menu des actions en masse. Ceci désactivera tous vos plugins. Si cela corrige le problème, vous devrez trouver le coupable. Commencez à les activer un par un, en rechargeant le site après chaque activation. Lorsque votre front-end s’effondre, vous avez trouvé le plugin qui se comporte mal. Vous pouvez alors contacter le développeur du plugin pour obtenir de l’aide ou poster un ticket de support dans le répertoire WordPress.

Désactiver tous les plugins WordPress

Désactiver tous les plugins WordPress

Si vous ne pouvez pas accéder à votre administration, vous pouvez vous connecter en FTP sur votre serveur et renommer votre dossier plugins en quelque chose comme plugins_old. Puis vérifiez à nouveau votre site. Si cela fonctionne, vous devrez tester chaque plugin un par un. Renommez votre dossier de plugins en « plugins » puis renommez chaque dossier de plugins à l’intérieu, un par un, jusqu’à ce que vous le trouviez.

Renommer le dossier du plugin WordPress

Renommer le dossier du plugin WordPress

Il en va de même pour vos thèmes WordPress. Vous pouvez remplacer temporairement votre thème par un thème WordPress par défaut, Twenty Seventeen est un bon choix. Si vous pouvez accéder à votre admin, allez dans « Thèmes » dans le menu Apparence, et vous pouvez activer le thème Twenty Seventeen puis tester à nouveau votre site. Si votre site s’affiche, le problème est dans votre thème.

Changer temporairement le thème WordPress

Changer temporairement le thème WordPress

Si vous ne pouvez pas accéder à votre administration, le processus est exactement le même qu’avec les plugins. Renommez votre dossier wp-content/themes en autre chose, comme themes_old. WordPress reviendra alors au dernier thème par défaut, qui est très probablement Twenty Seventeen (si vous n’avez pas d’autres thèmes, vous pouvez télécharger Twenty Seventeen  du répertoire WordPress et le télécharger dans votre dossier de thèmes. Puis vérifiez à nouveau votre site. Si cela fonctionne, alors peut-être que votre thème a un conflit ou une mauvaise mise à jour, dans ce cas vous pourriez avoir besoin de contacter le développeur de votre thème.

Renommer le dossier des thèmes WordPress

Renommer le dossier des thèmes WordPress

2. Résoudre les erreurs de syntaxe

Une autre raison courante pour l’écran blanc de la mort est si vous éditiez le code sur votre site WordPress et que vous avez accidentellement mal tapé quelque chose ou avez la mauvaise syntaxe. Un mauvais bout de code au mauvais endroit pourrait détruire tout votre site. Oui, c’est un peu effrayant ! C’est une des raisons pour lesquelles vous ne devriez jamais éditer du code sur votre site de production en direct.

Cependant, ne vous inquiétez pas. Vous pouvez toujours vous connecter à votre site via SFTP et annuler le changement que vous avez effectué manuellement. Si vous ne savez pas ce qui a changé, vous devriez avoir des sauvegardes WordPress en place. Ici, chez Kinsta, vous pouvez restaurer votre site en un seul clic à un moment antérieur.

Restaurer le site WordPress à partir d'une sauvegarde

Restaurer le site WordPress à partir d’une sauvegarde

3. Activer le débogage

Si vous voyez toujours l’écran blanc de la mort sur WordPress, ou si l’administration ne fonctionne pas (ou si vous avez trouvé le coupable mais que vous voulez creuser plus profondément) vous pouvez activer le débogage qui exposera toutes les erreurs. Le problème est que lorsqu’une erreur fatale se produit, le script termine simplement l’exécution. Si cela se produit avant l’affichage d’un contenu, vous ne verrez qu’un écran blanc sans aucun texte.

Pour activer le débogage, vous devez ouvrir le fichier wp-config.php file de votre installation WordPress. Vous devriez y trouver la ligne suivante :

define( 'WP_DEBUG', false )

Vous devrez remplacer false par true et et recharger votre site. Si elle n’existe pas, vous pouvez l’ajouter en haut.

Exemple WP_DEBUG

Exemple WP_DEBUG

Au lieu de l’écran blanc, vous obtiendrez un écran blanc et des messages d’erreur. Ce n’est pas une grande amélioration, mais au moins on peut commencer ! Si vous n’avez pas encore désactivé les plugins et les thèmes, vous serez en mesure de déterminer le coupable en regardant le message d’erreur. Il devrait indiquer dans quel fichier l’erreur provient, quelque chose comme ceci :

Cannot redeclare get_posts() (previously declared in /var/www/html/wordpress/wp-includes/post.php:1874) in /var/www/html/wordpress/wp-content/plugins/my-test-plugin/my-test-plugin.php on line 38

Vous pouvez voir à la fin du message que le problème est à la ligne 38 d’un plugin appelé « my-test-plugin ». Désactiver ce plugin devrait fonctionner.

Si vous êtes satisfait de la modification du code, vous pouvez également être en mesure de le corriger. Si c’est un plugin du répertoire, je recommande d’écrire à l’auteur au lieu de le faire vous-même. Si vous modifiez le plugin, vous devrez maintenir tous vos changements, ce qui est un casse-tête, il est plus facile de le désactiver jusqu’à ce qu’il soit corrigé par le développeur. Si vous ne voyez aucune erreur après avoir activé le débogage, vous devrez peut-être contacter votre hébergeur, car il se peut que le débogage ne soit pas correctement configuré sur votre serveur.

4. Augmenter les limites de mémoire

Si vous voyez toujours une page vide ou si vous obtenez une erreur en concernant la limite de mémoire ou l’épuisement de mémoire, vous devrez affecter plus de mémoire à l’application. Ceci peut être fait via le fichie wp-config.phpsur de nombreuses installations, il suffit d’ajouter le code suivant au fichier :

Vous avez des problèmes de temps d'indisponibilité et de WordPress ? Kinsta est la solution d'hébergement conçue pour vous faire gagner du temps ! Découvrez nos fonctionnalités
define('WP_MEMORY_LIMIT', '64M');

Si vous êtes sur un hébergeur génial comme Kinsta et que votre site web fonctionne à la vitesse de l’éclair parce que .htaccess file – in the WordPress root directory – to increase the memory limit, simply add the following line:

php_value memory_limit 64M

If you’re on an awesome host like Kinsta and your website runs lightning fast because l’architecture utilise NGINX, , le .htaccess n’est pas disponible. Vous pouvez utiliser votre fichier php.ini pour augmenter la limite de mémoire. N’importe où à l’intérieur du fichier, ajoutez la ligne suivante :

memory_limit = 64M

Si vous n’avez toujours pas plus de mémoire PHP et que vous avez besoin d’en assigner de plus en plus, il peut y avoir un problème dans votre application. Peut-être que votre thème ou l’un de vos plugins utilise une quantité démesurée de ressources. Demandez à un développeur de jeter un coup d’oeil, même votre hébergeur peut être en mesure de vous aider en vous montrant les logs SQL et autres statistiques de ressources.

5. Vérifier les problèmes d’autorisation des fichiers

Nous n’avons pas vu d’écran blanc de la mort à cause de cela, mais les problèmes de permission et de propriété peuvent encore causer des problèmes. Qui sait, dans certaines circonstances, cela peut mener à un écran blanc de mort ! Il est possible d’y remédier vous-même, mais à moins que vous ne sachiez vraiment ce que vous faites, nous vous le déconseillons. Pour WordPress, il y a trois règles simples :

    • Les fichiers devraient être en 664 ou 644,
    • Les dossiers doivent être en 775 ou 755
  • et le fichier wp-config.php doit être en 660, 600, ou 644

Si vous avez un accès SSH à votre serveur, vous pouvez appliquer les règles appropriées avec la commande suivante, en l’exécutant depuis le répertoire racine de WordPress.

sudo find . -type f -exec chmod 664 {} +
sudo find . -type d -exec chmod 775 {} +
sudo chmod 660 wp-config.php

 Si vous n’êtes pas sûr de la façon de procéder ou si vous avez un peu peur, allez-y, demandez à votre hébergeur. Certains hébergeurs spécifiques à WordPress ont même une vérification automatique des permissions qui peut résoudre tout cela pour vous.

6. Vérifier l’échec de la mise à jour automatique

Parfois WordPress peut rencontrer un problème avec les mises à jour, comme par exemple le timeout du serveur. Le plus souvent, cela se résout automatiquement, mais dans certains cas sauvages, cela peut conduire à un écran blanc de mort.

La première chose à faire est d’aller dans le répertoire racine de WordPress et de voir s’il y a un fichier .maintenance dedans. N’hésitez pas à supprimer ce fichier et à charger à nouveau votre site. Si la mise à jour a réussi, mais que WordPress n’a pas réussi à supprimer ce fichier automatiquement, tout redeviendra normal.
Si la mise à jour n’est pas terminée, elle peut se faire automatiquement pour vous, auquel cas les choses devraient tout de même revenir à la normale. Si tout le reste échoue, suivez la procédure de mise à jour manuelle recommandée par WordPress qui devrait résoudre le problème une fois pour toutes.

Résumé

Il y a un certain nombre de choses qui peuvent mal tourner, mais heureusement, la situation n’est généralement pas aussi grave qu’elle n’y paraît. Une simple vérification de plugin/thème devrait résoudre le problème et permettre le débogage qui apportera certainement plus de lumière sur le problème. Si vous avez rencontré d’autres situations d’écran blanc de la mort sur WordPress, faites-le nous savoir pour que nous puissions en tirer des leçons et partager l’expérience !