L'écran blanc de la mort (WSOD) sous WordPress : comment le réparer étape par étape, sans développeur

C'est le genre de matinée qu'on ne souhaite à personne : vous ouvrez votre site et, à la place de votre page d'accueil, vous tombez sur un écran entièrement blanc. Pas de texte, pas d'erreur, pas d'admin. Rien. On l'appelle le « White Screen of Death » (WSOD) et, aussi alarmant qu'il paraisse, il a le plus souvent une cause simple et réparable.

La bonne nouvelle : vous n'avez pas forcément besoin d'un développeur pour passer la première vague de panique. Il vous faut un plan calme, dans le bon ordre, pour ne pas aggraver la situation. Voici exactement les étapes qu'un professionnel suit quand il reçoit ce type d'appel d'urgence - de la plus simple à la plus technique. Faites-les une à une et, très probablement, votre site reviendra.

Ce qu'est réellement le WSOD et pourquoi il survient

Un écran blanc signifie presque toujours que le PHP qui génère votre page s'est arrêté sur une erreur grave (une « erreur fatale »), et WordPress n'a jamais pu rien afficher. Pour des raisons de sécurité, le message d'erreur est masqué au public - d'où la page vide.

Les causes les plus fréquentes sont peu nombreuses et reviennent souvent :

• un conflit d'extension (plugin) ou de thème, surtout juste après une mise à jour ;
• une limite de mémoire PHP dépassée ;
• une erreur de code dans un fichier modifié à la main (souvent functions.php) ;
• plus rarement, un problème de serveur ou de base de données.

L'essentiel est de ne pas deviner, mais d'éliminer les suspects un par un. Avant tout, si vous le pouvez, faites une sauvegarde de vos fichiers et de votre base de données. Une sauvegarde avant d'intervenir vous épargnera bien du stress si quelque chose tourne mal.

Étape 1 : activez les messages d'erreur pour voir la cause

Un écran blanc ne vous dit rien - mais vous pouvez le faire parler. Il vous faut un accès aux fichiers via FTP, le gestionnaire de fichiers de cPanel, ou le panneau de votre hébergeur.

Ouvrez wp-config.php à la racine du site et cherchez la ligne :

`define('WP_DEBUG', false);`

Remplacez-la par :

`define('WP_DEBUG', true);`

`define('WP_DEBUG_LOG', true);`

`define('WP_DEBUG_DISPLAY', false);`

Rechargez le site. Les erreurs seront écrites dans un fichier nommé debug.log, dans le dossier wp-content. Ouvrez-le et lisez les dernières lignes : elles indiquent généralement précisément quelle extension ou quel fichier a échoué, avec son nom et son numéro de ligne. C'est l'indice le plus précieux de toute l'opération. Une fois la réparation faite, remettez WP_DEBUG sur false pour que les visiteurs ne voient jamais d'erreurs.

Étape 2 : désactivez les extensions et changez de thème

Le coupable le plus fréquent est une extension. Si vous pouvez encore accéder à l'admin (wp-admin), désactivez les extensions une par une et rechargez après chacune, jusqu'à ce que le site revienne.

Si vous ne pouvez pas du tout entrer dans l'admin, faites-le via les fichiers :

• accédez à wp-content par FTP ou gestionnaire de fichiers ;
• renommez le dossier plugins en quelque chose comme plugins-off ;
• vérifiez le site.

S'il revient, une extension était en cause. Renommez le dossier en plugins, puis désactivez les extensions une à une (en renommant leurs sous-dossiers) jusqu'à trouver la coupable.

Si le problème persiste, testez le thème : renommez le dossier du thème actif dans wp-content/themes. WordPress reviendra à un thème par défaut (comme Twenty Twenty-quelque chose) et, si cela règle le souci, votre thème était en cause.

Étape 3 : augmentez la limite de mémoire PHP

Si debug.log affiche un message du type « Allowed memory size exhausted », votre site a manqué de mémoire. C'est une réparation simple.

Dans wp-config.php, ajoutez avant la ligne « That's all, stop editing » :

`define('WP_MEMORY_LIMIT', '256M');`

Si cela ne suffit pas, ou si vous n'êtes pas autorisé à le modifier depuis WordPress, vous pouvez augmenter la limite dans php.ini ou depuis le panneau de votre hébergeur (beaucoup d'hébergeurs proposent un réglage PHP où vous choisissez directement la valeur de mémoire).

Si vous n'avez pas accès à ces réglages, c'est le bon moment pour écrire au support de votre hébergeur : c'est une demande courante et ils la traitent vite. La mémoire insuffisante apparaît souvent sur les offres d'hébergement bon marché, surtout sur des sites avec beaucoup d'extensions ou une boutique WooCommerce.

Étape 4 : revenez à la dernière version saine, et quand demander de l'aide

Si tout a commencé après une mise à jour ou une modification manuelle, le plus propre est de revenir à l'état précédent. C'est pour cela que la sauvegarde compte : avec une copie récente, vous restaurez les fichiers et la base de données, et le site est de nouveau en ligne en quelques minutes.

Si vous avez modifié functions.php à la main et obtenu l'écran blanc, vous avez très probablement laissé une accolade ou un point-virgule en trop. Ouvrez le fichier et retirez la dernière modification que vous avez faite.

Demandez l'aide d'un professionnel quand : vous ne trouvez pas les fichiers, les erreurs pointent vers la base de données, ou le site vous rapporte de l'argent et chaque heure d'arrêt coûte cher. Chez MPO Web Studio, nous travaillons à distance dans tout le pays et pouvons prendre en charge ce type d'urgence rapidement - écrivez-nous sur WhatsApp, donnez-nous accès, et nous le remettons en ligne. Et pour les nouveaux clients, nous construisons des sites à la structure propre, avec une démo prête avant même de payer, justement pour que ce genre de frayeur reste rare.