Rechercher et remplacer dans la base de données WordPress

WordPress n'enregistre pas l'adresse de votre site à un seul endroit. Elle figure dans les réglages, mais aussi en toutes lettres dans vos articles, dans les images et dans les réglages des thèmes, des extensions et des widgets. Si vous changez d'adresse, vous devez donc la remplacer dans toute la base de données. Vous découvrirez ici comment le faire en toute sécurité, et pourquoi une simple requête SQL peut casser votre site.

Quand en avez-vous besoin ?

• Votre site était en http, il fonctionne désormais en https, et vous constatez du contenu mixte (une page en https qui charge des éléments via http). Consultez aussi Pas de cadenas ou « non sécurisé » : résoudre le contenu mixte.
• Vous déplacez votre site vers un autre domaine, ou d'une adresse temporaire vers votre véritable domaine.
• Vous avez créé manuellement une copie à une autre adresse, par exemple un site de test.

Si vous clonez un site avec Installatron ou le Website Manager, celui-ci adapte lui-même les adresses dans la copie. Consultez Cloner un site et créer un environnement de test (staging). Si vous changez uniquement d'hébergement en conservant le même domaine, aucune modification n'est nécessaire.

Pourquoi pas un simple REPLACE en SQL ?

Dans phpMyAdmin, vous pouvez remplacer tous les textes avec une seule requête SQL. Ne le faites pas pour les adresses. De nombreux réglages sont enregistrés sous forme sérialisée : PHP y ajoute la longueur de chaque texte. Cela ressemble à ceci :

s:27:"http://example.com/logo.png";

s:27 signifie : un texte de 27 caractères suit. Si vous le transformez en https://, le texte compte 28 caractères, mais la valeur indiquée reste 27. PHP ne peut alors plus lire la valeur et le réglage disparaît sans avertissement. Vous constatez alors par exemple un menu vide, un logo disparu ou des widgets manquants. Utilisez donc un outil qui met à jour ces longueurs.

D'abord une sauvegarde

La recherche et le remplacement sont immédiats et il n'existe pas de corbeille. Exportez au préalable votre base de données, consultez Exporter une base de données, ou créez en un clic une sauvegarde supplémentaire dans WebOké Backups, consultez WebOké Backups : consulter, restaurer ou télécharger une sauvegarde.

Méthode 1 : WP-CLI dans le Terminal ou via SSH

WP-CLI est l'outil officiel en ligne de commande de WordPress. Chez nous, vous l'utilisez avec la commande wp dans le Terminal de DirectAdmin ou via SSH. Celui-ci n'est disponible que dans les formules avec SSH. Pour savoir de quelles formules il s'agit, consultez Le Terminal dans votre navigateur.

1. Ouvrez le Terminal et accédez au dossier de votre WordPress : cd domains/example.com/public_html
2. Vérifiez d'abord ce qui changerait, sans rien modifier :

   wp search-replace 'http://example.com' 'https://example.com' --skip-columns=guid --dry-run

   Vous voyez pour chaque table combien de remplacements seraient effectués.
3. Si le résultat est correct, exécutez la même commande sans --dry-run.

Quelques options de la commande :

• Sans option supplémentaire, WP-CLI agit sur les tables que WordPress connaît. Si une extension utilise ses propres tables avec le même préfixe (par exemple wp_), ajoutez --all-tables-with-prefix. L'option --all-tables concerne toutes les tables de la base de données, y compris celles d'un autre site qui s'y trouverait.
• --skip-columns=guid laisse intacte la colonne guid, qui contient les identifiants fixes des articles. WordPress recommande de ne jamais la modifier, sinon les lecteurs de flux affichent à nouveau d'anciens articles comme s'ils étaient nouveaux.
• En cas de problème avec des réglages complexes, --precise fonctionne plus lentement mais de manière plus approfondie.

Méthode 2 : une extension

Si vous ne disposez pas du Terminal ou de SSH, utilisez une extension de recherche et remplacement qui prend en charge les données sérialisées. Vous en trouverez plusieurs dans le répertoire des extensions de wordpress.org. Lors de votre choix, lisez la description : elle doit indiquer que l'extension traite correctement les données sérialisées. Là aussi, utilisez d'abord le mode test si l'extension en propose un, et supprimez l'extension une fois terminé. Consultez aussi Choisir, évaluer et faire le tri dans les extensions WordPress.

Uniquement l'adresse WordPress et l'adresse du site ?

Vous n'accédez plus à l'administration après une modification, parce que WordPress vous redirige vers une mauvaise adresse ? Modifiez alors d'abord uniquement les lignes siteurl et home dans la table wp_options (le préfixe wp_ peut être différent chez vous). Ce sont des textes ordinaires, que vous pouvez modifier dans phpMyAdmin. Pour savoir comment faire, consultez Ouvrir et utiliser phpMyAdmin. Effectuez ensuite le reste avec WP-CLI ou une extension.

Ensuite

• Videz le cache de votre extension de cache et de votre navigateur.
• Si des pages renvoient une erreur 404, cliquez une fois sur Enregistrer dans Réglages > Permaliens. Consultez Mon site web ne fonctionne plus après la mise en ligne ou le déménagement.
• Vérifiez quelques pages, votre menu, votre logo et un formulaire. Ouvrez la console avec F12 pour voir s'il reste des messages concernant du contenu mixte.

Pour aller plus loin

• wp search-replace sur developer.wordpress.org (en anglais)
• Déplacer WordPress manuellement : fichiers, base de données et wp-config.php

Envie d'en apprendre davantage ? Suivez le cours WordPress gratuit, leçon 3.2 www, redirections et contenu mixte ou leçon 9.5 Déplacer un site WordPress.