Comprendre le problème
Réparer la base de données WordPress consiste à corriger les tables MySQL corrompues ou incohérentes. Trois méthodes existent : l'outil intégré repair.php activé via wp-config.php, la fonction « Réparer » de phpMyAdmin, et la commande wp db repair de WP-CLI. Une sauvegarde préalable est indispensable.
La piste à vérifier
Sauvegardez d'abord la base, puis activez WP_ALLOW_REPAIR dans wp-config.php et lancez /wp-admin/maint/repair.php ; en cas d'échec, utilisez phpMyAdmin ou WP-CLI.
Comment reconnaître ce bug
- Le site affiche des erreurs de base de données ou un message proposant une réparation
- Des contenus sont incohérents, manquants ou ne se sauvegardent plus
- Les performances se dégradent à cause de tables fragmentées
- phpMyAdmin signale des tables marquées comme corrompues
Qu’est-ce que ce bug ?
La base de données WordPress peut se dégrader : tables corrompues, index endommagés, données orphelines. La réparation analyse la structure des tables, corrige les incohérences et reconstruit les index défectueux. C'est une opération de maintenance courante qui résout de nombreuses pannes sans toucher aux fichiers du site.
Pourquoi ce problème apparaît
Tables corrompues
Un crash serveur ou une écriture interrompue a endommagé une ou plusieurs tables.
Index fragmentés
De nombreuses écritures et suppressions ont dégradé les index, ralentissant les requêtes.
Données orphelines
Métadonnées sans article parent, relations cassées laissées par des plugins désinstallés.
Interruption d'une opération
Un import, une mise à jour ou une migration coupée a laissé la base dans un état incohérent.
Comment réparer ce bug
Conservez une sauvegarde des fichiers et de la base de données. Testez les changements en préproduction lorsque c’est possible. Si vous ne maîtrisez pas une étape, demandez de l’aide avant de l’appliquer.
Sauvegarder la base de données
Avant toute réparation, exportez la base via phpMyAdmin ou wp db export afin de pouvoir revenir en arrière.
Activer l'outil de réparation WordPress
Ajoutez define('WP_ALLOW_REPAIR', true); dans wp-config.php, sans la placer dans une autre instruction.
Lancer repair.php
Ouvrez /wp-admin/maint/repair.php et choisissez « Réparer » ou « Réparer et optimiser » la base de données.
Retirer la ligne de réparation
Une fois la réparation finie, supprimez la ligne WP_ALLOW_REPAIR : laissée active, cette page est accessible sans authentification.
Réparer via phpMyAdmin ou WP-CLI
Si repair.php ne suffit pas, cochez les tables dans phpMyAdmin et lancez « Réparer la table », ou exécutez wp db repair.
Comment éviter qu’il revienne
- Programmez des sauvegardes automatiques de la base de données
- Optimisez périodiquement les tables pour éviter la fragmentation
- Nettoyez régulièrement les données orphelines et les transients
- Surveillez l'espace disque pour prévenir les corruptions liées à un disque plein
Questions fréquentes
Comment réparer la base de données WordPress sans plugin ?
Activez la constante WP_ALLOW_REPAIR dans wp-config.php et ouvrez /wp-admin/maint/repair.php. Vous pouvez aussi réparer les tables directement depuis phpMyAdmin ou avec la commande wp db repair de WP-CLI.
Faut-il une sauvegarde avant de réparer la base ?
Oui, impérativement. Une réparation peut, dans de rares cas, aggraver la perte de données sur une table très endommagée. Une sauvegarde garantit de pouvoir revenir à l'état précédent.
Pourquoi retirer la ligne WP_ALLOW_REPAIR après la réparation ?
Tant qu'elle est active, la page repair.php est accessible sans être connecté. La laisser en place crée une faille : on l'ajoute pour la réparation, on la retire aussitôt après.
Réparer la base accélère-t-il le site ?
Indirectement, oui : réparer et optimiser les tables défragmente les index et libère de l'espace, ce qui peut accélérer les requêtes. Mais la réparation vise d'abord à corriger les erreurs, pas à optimiser.
Que faire si la réparation échoue ?
Si repair.php, phpMyAdmin et WP-CLI échouent tous, la table est trop endommagée. La seule solution fiable est alors de restaurer une sauvegarde de la base antérieure à la corruption.