Site WordPress brisé après une mise à jour : revenir en arrière proprement

Qu'est-ce qui a été mis à jour ?

Quatre éléments se mettent à jour sur un site WordPress, et chacun se remet en arrière différemment : le cœur de WordPress, les extensions, le thème, et la version de PHP du serveur, que l'hébergeur fait évoluer de son côté. Pour savoir lequel a bougé :

• Les courriels de WordPress : après une mise à jour automatique, WordPress écrit à l'adresse d'administration du site, sous un objet comme « [Nom du site] Certaines extensions ont été mises à jour automatiquement », avec la liste de ce qui a changé.
• L'écran des extensions : la colonne « Mises à jour automatiques » montre celles qui se mettent à jour seules, et chaque ligne affiche la version en place.
• Outils > Santé du site > Informations : la section Serveur donne la version de PHP, et les sections Extensions et Thèmes la version de chaque composant.
• Les dates des dossiers : un dossier d'extension réécrit par une mise à jour porte la date de cette mise à jour.

wp plugin list
ls -lt wp-content/plugins | head

La première commande liste les extensions avec leur version et leur état ; la seconde, les dossiers d'extensions du plus récemment modifié au plus ancien. Recoupez avec l'heure à laquelle le site a changé.

Vider les caches avant de conclure

Après une mise à jour, les fichiers CSS et JavaScript changent de contenu, et un cache peut continuer à servir les anciens. Le résultat ressemble à une panne : mise en page défaite, menus qui ne s'ouvrent plus. Videz, dans cet ordre, le cache de l'extension de cache ou d'optimisation, le cache de l'hébergeur s'il en propose un, puis celui du navigateur, et rechargez la page. Si le site revient, la mise à jour n'était pas en cause.

Le site reste bloqué en maintenance

Pendant une mise à jour, WordPress crée un fichier .maintenance à la racine du site et affiche « Indisponibilité temporaire pour cause de maintenance. Veuillez revenir dans un instant. ». Quand la mise à jour est interrompue, le fichier reste en place. WordPress l'ignore dix minutes après l'heure qu'il contient ; pour ne pas attendre, ou si le message persiste, supprimez-le par SFTP ou par le gestionnaire de fichiers de l'hébergeur. Comme son nom commence par un point, activez l'affichage des fichiers cachés pour le voir.

Retournez ensuite dans Tableau de bord > Mises à jour : l'élément dont la mise à jour a été interrompue est à relancer, ou à réinstaller dans sa version précédente.

Remettre la version précédente d'une extension

Réinstaller la version précédente remplace les fichiers de l'extension et garde ses réglages, qui sont enregistrés dans la base de données.

wp plugin install nom-extension --version=2.4.1 --force

• Extension du répertoire WordPress.org : sur sa page publique, le lien « Vue avancée » mène à la liste « Versions précédentes ». Téléchargez l'archive voulue, puis, depuis l'écran « Ajouter des extensions », cliquez sur « Téléverser une extension » : WordPress reconnaît l'extension déjà installée et propose « Remplacer l’extension actuelle par celle que vous avez téléversée ».
• Extension achetée chez un éditeur : les versions précédentes se téléchargent en général depuis votre compte client chez lui.
• Ensuite : cliquez sur « Désactiver les mises à jour auto » en face de cette extension, jusqu'à ce que l'éditeur publie un correctif.

WordPress sait déjà revenir en arrière dans deux cas. Depuis la version 6.3, quand la mise à jour d'une extension ou d'un thème échoue en cours de route, l'ancienne version est remise en place. Depuis la version 6.6, quand la mise à jour automatique d'une extension active provoque une erreur fatale, WordPress réinstalle la version précédente. Une mise à jour qui aboutit et brise une fonction sans erreur fatale reste à reprendre à la main.

Le thème : la version précédente, et les modifications perdues

wp theme install nom-du-theme --version=3.1.0 --force

Une mise à jour de thème remplace tous ses fichiers. Des modifications faites directement dans les fichiers du thème, par exemple dans functions.php ou une feuille de style, disparaissent donc à chaque mise à jour. La copie de sauvegarde prise avant la mise à jour permet de les retrouver ; pour les garder durablement, elles se placent dans un thème enfant, que les mises à jour du thème parent laissent intact.

Le cœur de WordPress

WP-CLI réinstalle une version précise du cœur :

wp core update --version=7.0 --force

Une mise à jour majeure du cœur peut aussi faire évoluer la structure de la base de données, que cette commande laisse telle quelle. Le plus sûr est souvent de garder le cœur à jour et de remettre en arrière l'extension ou le thème incompatible. Si le retour du cœur est indispensable, il se fait depuis une sauvegarde complète prise avant la mise à jour.

La version de PHP, changée par l'hébergeur

Les hébergeurs font évoluer la version de PHP à mesure que les anciennes cessent de recevoir des correctifs de sécurité. Une extension ou un thème ancien peut alors s'arrêter sur une erreur fatale. Le panneau de l'hébergeur permet en général de choisir la version de PHP du site :

1. Notez la version en place, puis revenez à la précédente.
2. Vérifiez que le site fonctionne de nouveau.
3. Mettez à jour ou remplacez le composant en cause, repéré grâce au journal de débogage.
4. Repassez à la version récente.

Ce retour est une étape de dépannage : une version de PHP sans correctifs de sécurité expose le site. Selon le calendrier officiel publié sur php.net, PHP 8.1 ne reçoit plus de correctifs de sécurité depuis le 31 décembre 2025, PHP 8.2 en reçoit jusqu'au 31 décembre 2026 et PHP 8.3 jusqu'au 31 décembre 2027. WordPress recommande PHP 8.3 ou plus récent.

Restaurer une sauvegarde complète, en dernier recours

Une restauration remet les fichiers et la base de données dans l'état de la sauvegarde. Tout ce que le site a reçu depuis disparaît : commandes, messages de formulaire, commentaires, inscriptions, articles publiés.

1. Exportez d'abord ce qui est arrivé depuis la sauvegarde : commandes, entrées de formulaires, nouveaux comptes.
2. Restaurez fichiers et base de données du même instant, depuis l'outil de l'hébergeur ou votre extension de sauvegarde. Des fichiers d'un jour et une base d'un autre jour produisent des erreurs difficiles à lire.
3. Réimportez les données exportées.
4. Réappliquez les mises à jour une à une, en vérifiant le site entre chacune : la dernière appliquée avant la panne est celle qui la cause.

Pour la prochaine mise à jour

• Une copie de test : beaucoup d'hébergeurs proposent un environnement de préproduction qui copie le site en un clic. Les mises à jour s'y appliquent d'abord.
• Une sauvegarde juste avant, fichiers et base de données ensemble.
• Une mise à jour à la fois, avec une vérification des pages clés entre chacune : accueil, formulaire de contact, panier.
• Le journal des modifications de l'extension ou du thème, lu avant une mise à jour majeure.