Ça commence généralement par un e-mail d’un client : « le site a l’air bizarre » ou « le paiement ne marche plus ». Vous regardez le tableau de bord et tout indique « mise à jour réussie ». Et pourtant le site est cassé. Ce guide vous explique quoi faire dans les dix premières minutes, comment rétablir le site sans perdre les commandes ou les envois de formulaires du jour, et comment faire en sorte que la prochaine mise à jour ne fasse pas la même chose.
Votre site est en panne en ce moment ? Commencez par la version courte : réparer un site cassé après une mise à jour WordPress, en 7 étapes.
Les dix premières minutes : découvrir ce qui est vraiment cassé
Résistez à l’envie de cliquer sur « mettre à jour » pour autre chose ou de restaurer tout le site d’emblée. Établissez d’abord quel type de panne vous avez sous les yeux. Il existe trois types courants, et chacun a une solution différente.
- Écran blanc ou message « erreur critique ». PHP s’est arrêté. En général, une extension incompatible avec la version de PHP ou avec une autre extension. WordPress envoie un e-mail à l’adresse de l’administrateur avec le nom de l’extension et le fichier qui a échoué ; regardez d’abord cette boîte de réception.
- Le site se charge, mais quelque chose cloche à l’affichage. Un menu qui ne s’ouvre plus sur mobile, une grille de produits qui a perdu ses colonnes, un formulaire qui s’affiche en texte brut. Ce sont des problèmes de mise en page et de JavaScript, souvent causés par la mise à jour d’un thème, d’un constructeur de pages ou d’une extension de cache.
- Le site a l’air normal, mais quelque chose ne fonctionne plus. Des formulaires qui n’envoient pas, un paiement qui bloque, des connexions qui échouent. Souvent une extension qui a changé la façon dont elle enregistre ses réglages, ou deux extensions qui chargent des scripts en conflit.
Ouvrez le site dans une fenêtre de navigation privée sur ordinateur et sur téléphone, et regardez les cinq pages les plus importantes : la page d’accueil, les pages du menu principal, le formulaire de contact, la boutique et le paiement s’il y en a, et la page de connexion. Notez ce que vous voyez. Vous aurez de nouveau besoin de cette liste pour vérifier la correction.
Étape 1 : identifier la mise à jour en cause
Allez dans Tableau de bord → Mises à jour, ou dans Extensions, et regardez quelles extensions, quels thèmes ou quelles versions du cœur ont changé aujourd’hui. Si plusieurs mises à jour ont tourné en même temps, les suspects les plus probables sont, dans cet ordre : le constructeur de pages ou le thème, WooCommerce et ses extensions, les extensions de cache et d’optimisation, et les extensions de sécurité. Tout ce qui touche à la façon dont les pages sont construites ou dont les scripts sont chargés a plus de chances de causer une panne visible qu’une petite extension utilitaire.
Si vous accédez encore à l’administration, activez brièvement le débogage pour voir l’erreur réelle : ajoutez define('WP_DEBUG', true); et define('WP_DEBUG_LOG', true); à wp-config.php, rechargez la page cassée et lisez wp-content/debug.log. Les premières lignes du journal nomment généralement l’extension. Désactivez ensuite le débogage ; il ne doit jamais rester activé sur un site en ligne.
Étape 2 : rétablir le site, de la manière la moins destructrice
Allez de la plus petite correction à la plus grosse. Chaque étape ci-dessous est moins précise et plus perturbante que la précédente, alors arrêtez-vous dès que le site refonctionne.
- Videz tous les caches. Cache de pages, cache d’objets, cache du CDN et navigateur. Un nombre étonnant de mises à jour « cassées » sont en fait de l’ancien CSS servi avec le nouveau HTML. Si le site est correct après un rechargement forcé d’une page non mise en cache, c’est terminé.
- Désactivez l’extension suspecte. Si vous pouvez vous connecter, désactivez-la et vérifiez de nouveau les cinq pages. Si vous ne pouvez pas vous connecter, renommez son dossier via SFTP ou dans le gestionnaire de fichiers de votre hébergement (
wp-content/plugins/plugin-name→plugin-name-off) ; WordPress la désactivera au prochain chargement de page. - Revenez à la version précédente de cette seule extension. La plupart des extensions sur WordPress.org conservent les anciennes versions sous « Vue avancée » sur leur page. Téléchargez la version précédente, supprimez celle qui est cassée, téléversez l’ancienne et réactivez-la. Pour les extensions premium, l’espace client de l’éditeur propose généralement les anciennes versions. Tout le contenu et toutes les commandes du jour restent intacts, car vous n’avez touché qu’aux fichiers de l’extension.
- Ensuite seulement, restaurez une sauvegarde. Une restauration complète remet les fichiers et la base de données dans l’état du moment de la sauvegarde. Tout ce que le client a fait depuis, comme des commandes, des envois de formulaires et des modifications, est perdu, sauf si vous le réintégrez à la main. Avant de restaurer, vérifiez quand la sauvegarde a été faite et demandez au client ce qui s’est passé sur le site depuis. Si possible, restaurez uniquement les fichiers et gardez la base de données actuelle ; beaucoup d’outils de sauvegarde le permettent.
Après chaque étape, reprenez votre liste des cinq pages sur ordinateur et mobile. « La page d’accueil se charge » n’est pas la même chose que « le site fonctionne ».
Étape 3 : prévenir le client avant qu’il ne vous prévienne
Envoyez un message court dès que le site est rétabli : ce qui a cassé, pendant combien de temps, ce que vous avez fait et ce que vous allez faire pour l’éviter. Les clients pardonnent une mise à jour ratée ; ils ne pardonnent pas de l’apprendre par un de leurs clients. Un message de deux lignes suffit. Gardez les détails techniques pour vos propres notes.
Étape 4 : faire en sorte que ça ne se reproduise pas
Chaque mise à jour cassée de ce guide a la même cause : la mise à jour a tourné sur le site en ligne, et la première vérification a eu lieu alors qu’elle était déjà en ligne. La solution consiste à changer l’ordre, pas à arrêter de mettre à jour. Une routine qui fonctionne pour les agences qui gèrent beaucoup de sites clients :
- Gardez une sauvegarde fraîche, chaque nuit. Fichiers et base de données. Une sauvegarde à partir de laquelle vous pouvez vraiment restaurer, ce qui veut dire que vous avez testé une restauration au moins une fois.
- Lancez d’abord la mise à jour sur une copie du site. Pas sur le site en ligne. Si votre hébergement n’a pas de fonction de préproduction, une copie dans un sous-dossier du même serveur convient à la plupart des sites ; voir notre guide pour tester les mises à jour WordPress avant la mise en ligne.
- Comparez les pages clés, sur ordinateur et sur mobile, avant et après. La plupart des pannes sont visuelles et ne produisent pas d’erreur. Des captures d’écran avant et après les repèrent ; notre guide sur les tests de régression visuelle pour WordPress explique comment faire.
- Ne mettez à jour le site en ligne qu’après la réussite sur la copie, et vérifiez-le encore une fois. La routine complète, y compris ce qu’il faut faire après la mise à jour, se trouve dans notre checklist de mise à jour WordPress pour agences.
- Mettez à jour par petits lots. Une seule mise à jour du constructeur de pages vous en apprend plus que douze mises à jour d’un coup. Quand quelque chose casse, vous savez ce qui l’a causé.
Questions fréquentes
Peut-on annuler une mise à jour d’extension WordPress ?
Oui. WordPress n’a pas de bouton d’annulation, mais vous pouvez installer à la main la version précédente de l’extension (les anciennes versions sont disponibles sur la page WordPress.org de l’extension sous « Vue avancée », ou dans l’espace client de l’éditeur pour les extensions premium), ou utiliser un outil de retour en arrière d’extensions. Désactivez ou supprimez d’abord la version actuelle, puis téléversez l’ancienne. Vos réglages restent normalement dans la base de données.
Restaurer une sauvegarde fera-t-il perdre les commandes récentes de mon client ?
Une restauration complète remet la base de données à l’heure de la sauvegarde, donc les commandes, envois ou modifications faits après ce moment disparaissent, sauf si vous les réintégrez à la main. C’est pourquoi revenir en arrière sur une seule extension est la meilleure première étape, et pourquoi une restauration ne doit être que le dernier recours. Si vous devez restaurer, restaurez uniquement les fichiers et gardez la base de données actuelle quand votre outil de sauvegarde le permet.
Le tableau de bord indiquait « mise à jour réussie », alors pourquoi le site est-il cassé ?
« Réussie » signifie seulement que les nouveaux fichiers ont été copiés à leur place. WordPress ne vérifie pas si la mise en page, les formulaires ou le paiement fonctionnent encore ensuite. Cette vérification doit se faire sur le site lui-même, page par page, sur ordinateur et sur mobile. La faire sur une copie avant la mise à jour en ligne, c’est ce qui évite l’e-mail du client dès le départ.
Comment empêcher WordPress de mettre à jour automatiquement les extensions ?
Sur l’écran Extensions, chaque extension a un lien « Activer/Désactiver les mises à jour auto ». Désactiver les mises à jour automatiques pour les constructeurs de pages, WooCommerce et les extensions liées au thème est raisonnable ; laissez-les actives pour les petites extensions de sécurité si vous ne mettez pas souvent à jour. Mieux encore : une routine où chaque mise à jour, automatique ou non, est d’abord testée sur une copie.
Vous voulez que la mise à jour soit testée avant de pouvoir casser quoi que ce soit ?
Chaque mise à jour est vérifiée, et les plus risquées sont d’abord testées sur une copie du site : Verploy compare les pages clés sur ordinateur et mobile et ne passe en ligne que si rien ne cloche. Si quelque chose casse après la mise en ligne, il revient en arrière de lui-même. Commencez gratuitement, sans carte bancaire.