Comment mettre à jour votre base de données WordPress (+ corriger la boucle « Mise à jour requise »)

Vous avez mis à jour WordPress, et maintenant votre tableau de bord ne cesse de vous dire que la base de données a également besoin d'une mise à jour.

Vous cliquez sur le bouton. Il indique « Aucune mise à jour requise, votre base de données est déjà à jour ». Ensuite, vous rechargez la page, et le même message réapparaît.

Cela arrive plus souvent que les gens ne le pensent, et la raison n'est pas toujours évidente.

Parfois, il s'agit d'un problème de cache ou d'une incompatibilité de version entre vos fichiers WordPress et votre base de données. D'autres fois, il s'agit d'une table corrompue qui pose problème discrètement depuis des mois et qui ne bloque quelque chose que maintenant.

Dans ce guide, je vais d'abord vous expliquer le processus de mise à jour standard, puis couvrir les moyens de résoudre la boucle si vous êtes bloqué dedans.

Je vais également vous montrer comment vérifier l'état de votre base de données avant de mettre à jour, afin que vous soyez moins susceptible de rencontrer ce problème en premier lieu.

Voici les points clés à retenir :

• La mise à jour du tableau de bord en un clic gère la base de données automatiquement ; les méthodes 2 et 3 (forcer via URL, WP-CLI) ne sont nécessaires que pour les mises à jour manuelles de fichiers ou les réseaux Multisite.
• La boucle « mise à jour requise » est rarement un vrai problème de base de données. Il s'agit le plus souvent d'un cache d'objet obsolète ou d'un plugin de cache servant un écran d'administration périmé, réparable en quelques minutes.
• Une vérification de l'état avant la mise à jour peut éviter complètement la boucle. La surcharge des tables et les problèmes structurels que DB Optimizer signale sont une raison fréquente pour laquelle les mises à jour restent bloquées à mi-chemin.
• Les mises à jour de la base de données et la configuration de la base de données sont deux choses différentes — les mises à jour du schéma se font automatiquement après une mise à jour du cœur ; les détails de connexion dans wp-config.php n'ont besoin d'être modifiés qu'après une migration.
• Sauvegardez toujours avec Duplicator avant de mettre à jour. Si un conflit de plugin casse quelque chose pendant la mise à jour, restaurer à partir d'une sauvegarde est plus rapide que de dépanner à l'aveugle.

Table des matières

Pourquoi mettre à jour votre base de données WordPress ?

Chaque mise à jour du cœur de WordPress peut inclure des modifications à la structure de la base de données, pas seulement au code. Les nouvelles fonctionnalités nécessitent parfois de nouvelles tables, de nouvelles colonnes ou des modifications dans la façon dont les données existantes sont organisées.

Lorsque vous mettez à jour WordPress, les fichiers du cœur sont mis à jour en premier. Ensuite, si la nouvelle version nécessite des modifications de la base de données, WordPress vous affiche une notification vous demandant de mettre à jour la base de données également.

Si vous sautez cette étape, vous finissez par exécuter le nouveau code WordPress sur une ancienne structure de base de données. Les plugins qui dépendent du nouveau schéma génèrent des erreurs. Certains écrans d'administration cessent de se charger correctement.

Dans certains cas, le site reste utilisable mais des fonctionnalités spécifiques échouent discrètement.

La mise à jour de la base de données elle-même est généralement rapide. C'est la partie où l'on reste bloqué qui prend du temps, c'est pourquoi la majeure partie de ce guide porte sur la prévention et le dépannage plutôt que sur la mise à jour elle-même.

Avant de mettre à jour votre base de données WordPress

Deux choses avant de toucher la page Mises à jour : sauvegardez tout, et vérifiez l'état actuel de votre base de données.

Sauter l'une ou l'autre rend le dépannag plus nécessaire.

Étape 1 : Sauvegardez votre site complet

Avant de mettre à jour votre base de données WordPress, créez une sauvegarde complète de votre site. Cela inclut votre base de données, vos fichiers et toute autre donnée importante.

Avoir une sauvegarde récente et fiable vous permettra de restaurer facilement votre site si quelque chose se passe mal pendant le processus de mise à jour.

Pour ce faire, je vous recommande d'utiliser Duplicator. Contrairement à d'autres plugins de sauvegarde, il peut remettre votre site web en état de marche même s'il est complètement hors ligne.

Ouvrez Duplicator depuis votre tableau de bord WordPress et créez une nouvelle sauvegarde. Pour une mise à jour du cœur, sauvegardez l'intégralité de votre site, pas seulement la base de données.

Les mises à jour du cœur touchent les fichiers ainsi que la base de données, donc une sauvegarde de la base de données seule ne vous couvrira pas si la mise à jour des fichiers cause un problème.

Nommez la sauvegarde de manière à la reconnaître plus tard et choisissez un emplacement de stockage. Si vous avez un stockage cloud connecté (comme Duplicator Cloud), Duplicator peut y envoyer la sauvegarde automatiquement.

Une fois la sauvegarde terminée, vous la verrez listée sur la page Sauvegardes. C'est votre point de restauration si quelque chose se passe mal dans les étapes suivantes.

Au cas où quelque chose tournerait mal, il est conseillé de définir cette sauvegarde comme point de récupération en cas de catastrophe. Cliquez sur l'icône de la maison bleue.

Une fois que vous avez défini la récupération d'urgence, vous obtiendrez deux façons différentes de restaurer votre site. Copiez le lien de récupération ou téléchargez le fichier lanceur.

Si vous êtes complètement bloqué hors de votre tableau de bord d'administration, collez le lien de récupération dans une fenêtre de navigateur. Ou, ouvrez le fichier lanceur. Duplicator restaurera automatiquement cette sauvegarde que vous venez de créer.

Je fais cela avant chaque mise à jour du cœur, même les mineures. Les cinq minutes que cela prend ne sont rien comparées au dépannage d'un site cassé sans sauvegarde.

Étape 2 : Effectuez une vérification de l'état de la base de données avec DB Optimizer

Cette étape détecte ce que le processus de mise à jour standard ne vérifie pas : une base de données qui a déjà des problèmes avant même de commencer.

Avant de mettre à jour, nettoyons votre base de données avec DB Optimizer. Ce plugin est gratuit avec Duplicator Pro.

La première chose que vous verrez est un score de santé de 0 à 100, réparti en cinq domaines : Surcharge de table, Transitoires, Révisions, Taille de l'autoload et Éléments dans la corbeille.

Vous recherchez une chose en particulier ici : la surcharge de table. Si cette barre est jaune ou rouge, cela signifie généralement qu'une ou plusieurs tables ont accumulé de l'espace perdu ou, dans certains cas, des problèmes structurels dus à des opérations incomplètes.

Une base de données avec des problèmes au niveau des tables est plus susceptible de rencontrer des difficultés lors d'une mise à jour de schéma. Si une table que la mise à jour doit modifier est déjà dans un mauvais état, la mise à jour peut échouer à mi-chemin, ce qui est l'une des raisons pour lesquelles les gens se retrouvent bloqués dans la boucle que j'ai mentionnée précédemment.

Ouvrez l'onglet Nettoyage et exécutez toutes les optimisations disponibles.

Ensuite, allez dans l'onglet Tables. Optimisez toutes les tables avec une surcharge.

Une fois que votre score de santé semble raisonnable et que la surcharge de table est effacée, vous êtes prêt à mettre à jour !

Comment mettre à jour votre base de données WordPress

Il existe trois façons d'exécuter une mise à jour de base de données WordPress. Voici ce que vous ferez :

• Méthode 1 : La mise à jour en un clic depuis le tableau de bord : le chemin standard pour la plupart des mises à jour, où WordPress vous invite automatiquement après une mise à jour du cœur
• Méthode 2 : Forcer la mise à jour via l'URL : pour lorsque vous avez mis à jour manuellement les fichiers WordPress et que l'invite de base de données n'apparaît pas d'elle-même
• Méthode 3 : Utiliser WP-CLI : pour mettre à jour la base de données depuis la ligne de commande, utile pour les réseaux Multisite ou lorsque la méthode du tableau de bord ne se charge pas

La plupart des gens n'ont besoin que de la Méthode 1. Les deux autres sont là pour les situations où la Méthode 1 ne s'applique pas ou ne fonctionne pas.

Méthode 1 : La mise à jour du tableau de bord en un clic

Généralement, la mise à niveau des bases de données WordPress est un processus simple. Commencez par mettre à jour votre site Web vers la dernière version de WordPress. Vous pouvez le faire sur la page Mises à jour.

Si votre base de données a également besoin d'une mise à jour, un message apparaîtra. Cliquez sur Mettre à jour la base de données WordPress.

Lorsque c'est terminé, vous verrez un message de succès et un bouton Continuer. Cliquez dessus, et vous reviendrez à votre tableau de bord comme d'habitude.

Si aucune modification de base de données n'était nécessaire pour cette version, vous ne verrez pas cet écran du tout. C'est normal. Toutes les mises à jour du cœur n'incluent pas de modifications de la base de données.

Méthode 2 : Forcer la mise à jour de la base de données via l'URL

Utilisez ceci si vous avez mis à jour vos fichiers WordPress manuellement, via FTP ou le gestionnaire de fichiers de votre hébergement, et que l'invite de mise à jour de la base de données n'est jamais apparue.

Ouvrez votre navigateur et allez directement à : votredomaine.com/wp-admin/upgrade.php

Assurez-vous de remplacer ceci par l'URL de votre site. WordPress vous indiquera si votre base de données est à jour.

Méthode 3 : Utiliser WP-CLI

Si vous avez un accès SSH à votre serveur, WP-CLI offre le moyen le plus rapide d'exécuter une mise à jour de la base de données, et c'est particulièrement utile si le tableau de bord ne se charge pas correctement.

Connectez-vous à votre serveur via SSH et naviguez jusqu'au répertoire racine de votre WordPress :

cd /path/to/your/wordpress

Exécutez ensuite :

wp core update-db

Ceci met à jour la base de données pour une installation sur un seul site. Vous verrez un message de confirmation une fois que ce sera fait.

Si vous gérez un réseau Multisite, utilisez ceci à la place pour mettre à jour tous les sites du réseau en une seule fois :

wp core update-db --network

WP-CLI vous donne une sortie directe, donc si quelque chose échoue, vous verrez un message d'erreur. Cela le rend utile pour diagnostiquer les problèmes, même si vous finissez par les résoudre via le tableau de bord.

Comment résoudre la boucle de mise à jour de la base de données WordPress requise

Lorsque vous mettez à jour votre base de données WordPress, vous risquez de rester bloqué dans une boucle « mise à jour de la base de données requise ». Cela se produit lorsque WordPress détecte que votre base de données a besoin d'une mise à jour, mais que, pour une raison quelconque, le processus de mise à jour ne s'achève pas correctement.

Si cette erreur se produit, WordPress vous demandera continuellement de mettre à jour la base de données à chaque chargement de page, créant ainsi une boucle infinie.

Commençons par vérifier que la valeur db_version dans votre base de données est la même que dans le fichier version.php.

Dans cPanel, ouvrez Bases de données » phpMyAdmin. Sélectionnez votre base de données et cliquez sur la table wp_options. Notez la valeur option_value pour db_version.

Ensuite, ouvrez les fichiers de votre site. Accédez au répertoire wp-include et trouvez le fichier version.php. Dans ce fichier, vous devriez voir une ligne comme celle-ci :

$wp_db_version = 57155;

Assurez-vous que ces valeurs sont identiques. Vous devrez peut-être mettre à jour votre fichier version.php.

Une autre façon de résoudre cette erreur est de trouver le fichier object-cache.php dans votre répertoire wp-content. Supprimez ou renommez ce fichier.

Si cela n'a pas fonctionné, le problème pourrait être un problème au niveau de la table qui empêche la mise à jour de s'achever. Vous pouvez utiliser DB Optimizer pour réparer les tables de la base de données !

Comment mettre à jour la configuration de votre base de données WordPress

Vous devrez peut-être également mettre à jour les détails de connexion de la base de données WordPress dans le fichier de configuration de votre site (wp-config.php). Ce fichier contient les identifiants et les paramètres nécessaires à WordPress pour se connecter à votre base de données.

Le fichier wp-config.php est situé dans le répertoire racine de votre installation WordPress. À l'intérieur de ce fichier, vous trouverez les détails de connexion à la base de données suivants :

• DB_NAME : Le nom de votre base de données WordPress
• DB_USER : Le nom d'utilisateur utilisé pour accéder à votre base de données WordPress
• DB_PASSWORD : Le mot de passe utilisé pour accéder à votre base de données WordPress
• DB_HOST : L'hôte ou le serveur où se trouve votre base de données WordPress

Ces valeurs peuvent changer si vous avez migré votre site vers un nouvel hôte ou serveur. Vous devrez mettre à jour votre base de données WordPress après les migrations.

Il est important d'être très prudent lors de la modification du fichier wp-config.php, car une seule faute de frappe peut empêcher votre site de se connecter à la base de données. Sauvegardez toujours votre fichier wp-config.php avant d'apporter des modifications.

Pour vérifier les paramètres de configuration de votre base de données WordPress, ouvrez phpMyAdmin. Sélectionnez votre base de données.

Vérifiez la première partie des noms de table pour obtenir le préfixe de votre base de données. Il s'agira très probablement de wp_.

Retournez à la section Bases de données et cliquez sur Bases de données MySQL.

Trouvez votre base de données actuelle. Notez le nom d'utilisateur et le mot de passe correspondants.

Ouvrez maintenant votre fichier wp-config.php. Modifiez le nom de la base de données, l'utilisateur et le mot de passe avec les informations que vous venez de découvrir.

Définissez DB_Host sur localhost. Ajoutez également votre préfixe de table.

Après cela, enregistrez le fichier.

Si vous n’êtes pas sûr de la manière de mettre à jour correctement la configuration de la base de données, il est préférable de consulter votre fournisseur d’hébergement ou un développeur WordPress. Une mauvaise configuration de la connexion à votre base de données peut entraîner de graves problèmes avec votre site.

Questions fréquemment posées (FAQ)

La réinitialisation de votre base de données WordPress doit toujours être effectuée avec une extrême prudence, car elle effacera tout le contenu, les paramètres et les données utilisateur de votre site. N’essayez de réinitialiser la base de données que si vous disposez d’une sauvegarde complète de votre site que vous pouvez restaurer.

Votre base de données est mise à jour, voici ce qu'il faut surveiller ensuite

Votre base de données WordPress fonctionne maintenant sur la version actuelle, correspondant à vos fichiers du cœur mis à jour. Votre site continue de fonctionner exactement comme avant, juste sur une base mise à jour.

Gardez un œil sur les plugins après une mise à jour du cœur, surtout dans les jours qui suivent. Certains plugins fournissent leurs propres modifications de base de données qui s'exécutent indépendamment de la mise à jour du cœur de WordPress, et celles-ci peuvent faire surface des problèmes un jour ou deux plus tard.

Exécutez à nouveau une vérification de l’état de DB Optimizer après la mise à jour. Certains processus de mise à jour laissent des données temporaires ou une surcharge supplémentaire. Une vérification rapide après la mise à jour (et un nettoyage si nécessaire) vous aide à partir d’une base de référence propre.

Chaque mise à jour de base de données comporte un certain risque, même minime. La différence entre une correction rapide et un après-midi stressant dépend généralement du fait que vous ayez une sauvegarde que vous pouvez réellement restaurer.

Plus de 1,5 million de professionnels WordPress utilisent Duplicator pour sauvegarder leurs sites avant chaque mise à jour, migration et changement majeur. DB Optimizer est inclus avec Duplicator Pro, vous pouvez donc vérifier l’état de votre base de données et la sauvegarder avant chaque mise à jour.

Pendant que vous êtes ici, je pense que vous aimerez ces guides WordPress supplémentaires :

• Comment Black Bike Media a sauvé une base de données corrompue de 2,4 Go
• Comment optimiser votre base de données WordPress : obtenez un site rapide en 10 étapes
• Comment copier une base de données WordPress (4 méthodes)
• 13 meilleurs plugins de base de données WordPress pour une gestion facile des données
• WordPress 101 : Comment créer une base de données WordPress