Changer le domaine ou l'URL de WordPress

Quand vous changez de domaine, déplacez WordPress dans un sous-répertoire ou publiez une copie, il peut être nécessaire de modifier son URL principale. La méthode dépend de l'accès que vous gardez à l'installation.

Avant d'utiliser l'une de ces méthodes, gardez une sauvegarde récupérable des fichiers et de la base de données, vérifiez que le nouveau domaine pointe vers le bon répertoire et que son certificat HTTPS fonctionne. Ce guide couvre une installation simple ; un réseau Multisite nécessite une procédure spécifique.

Voici trois méthodes principales pour changer l'URL de WordPress, de la plus simple à la plus technique.

Méthode 1 : depuis le tableau de bord de WordPress (wp-admin)

C'est la façon la plus simple et recommandée quand vous avez accès au tableau de bord de WordPress.

1. Connectez-vous au tableau de bord de WordPress (wp-admin)

2. Allez dans Réglages → Général

3. Modifiez les champs :

   • Adresse web de WordPress (URL) : l'URL où se trouvent les fichiers principaux de WordPress
   • Adresse web du site (URL) : l'URL que verront les visiteurs

4. Cliquez sur Enregistrer les modifications

Important : assurez-vous que les deux URL sont correctes avant d'enregistrer, car une erreur pourrait vous priver d'accès au tableau de bord.

Méthode 2 : en modifiant le fichier wp-config.php

Utilisez cette méthode quand vous n'avez pas accès au tableau de bord à cause du changement d'URL.

1. Connectez-vous à votre compte par FTP ou avec le gestionnaire de fichiers
2. Repérez et modifiez le fichier wp-config.php à la racine de votre installation WordPress
3. Si ces constantes existent déjà, modifiez leurs valeurs sans les dupliquer. Si elles n'existent pas, ajoutez les lignes suivantes avant le commentaire « C'est tout, ne touchez pas à ce qui suit ! », avant le chargement de WordPress :

define('WP_HOME','https://tudominio.com');
define('WP_SITEURL','https://tudominio.com');

Remplacez tudominio.com par votre vrai domaine. WP_SITEURL doit indiquer où se trouvent les fichiers de WordPress et WP_HOME l'adresse publique du site ; elles ne seront identiques que si les deux emplacements coïncident.

Ces constantes prévalent sur home et siteurl dans la base de données, mais ne modifient pas leurs valeurs. Tant qu'elles sont définies, vous ne pourrez pas non plus modifier les adresses depuis Réglages > Général. Si vous les utilisez pour retrouver l'accès, mettez ensuite à jour les options enregistrées et retirez les constantes pour éviter que l'ancienne URL réapparaisse.

Méthode 3 : en modifiant directement la base de données (phpMyAdmin)

Cette méthode est plus technique et doit être utilisée avec prudence.

Procédure de modification :

1. Ouvrez phpMyAdmin depuis le panneau de contrôle de votre hébergement

2. Sélectionnez la base de données de votre WordPress

3. Vérifiez DB_NAME et $table_prefix dans wp-config.php pour identifier la bonne base et la bonne table. Repérez wp_options ou la table équivalente avec ce préfixe

4. Cherchez les lignes suivantes et modifiez leurs valeurs dans la colonne option_value :

   • home : remplacez-la par la nouvelle URL (exemple : https://tudominio.com)
   • siteurl : remplacez-la par la nouvelle URL (exemple : https://tudominio.com)

5. Enregistrez les modifications

Étape supplémentaire recommandée : mettre à jour les références internes

Après avoir changé l'URL principale avec l'une des méthodes précédentes, il est fortement recommandé de mettre à jour toutes les références internes que WordPress stocke dans la base de données, car de nombreux éléments (images, liens internes, widgets, etc.) peuvent encore pointer vers l'ancienne URL.

Avant cela, créez une sauvegarde récupérable de la base de données. N'exécutez pas de remplacement SQL direct et ne modifiez pas l'export comme du texte : WordPress et ses extensions stockent des données sérialisées qui seraient endommagées si la longueur d'une URL change.

Pourquoi cette étape supplémentaire est-elle nécessaire ?

Même si l'URL principale de WordPress a été changée, la base de données peut contenir des milliers de références à l'ancienne URL dans :

• Le contenu des articles et des pages
• Les URL des images et des fichiers multimédias
• Les réglages des widgets et des menus
• Les options des thèmes et des extensions

Avec Better Search & Replace

1. Installez l'extension Better Search & Replace depuis le répertoire officiel de WordPress

2. Allez dans Outils → Better Search Replace

3. Configurez les champs :

   • Search for : l'ancienne URL complète (exemple : https://dominioviejo.com)
   • Replace with : la nouvelle URL complète (exemple : https://dominionuevo.com)
   • Select tables : sélectionnez les tables de l'installation que vous allez modifier
   • Run as dry run? : laissez-la cochée lors de la première exécution pour vérifier le nombre de modifications

4. Vérifiez le résultat de la simulation et, seulement s'il est correct, répétez l'opération avec cette option décochée.

Ne remplacez pas uniquement le domaine nu : vous pourriez modifier des adresses e-mail ou d'autres valeurs qui ne sont pas des URL. Traitez séparément les variantes http, https, www ou les sous-répertoires que vous avez confirmés dans la base.

Avec WP-CLI (méthode avancée)

Si vous avez accès à WP-CLI, exécutez la commande depuis le dossier de la bonne installation, ou indiquez son chemin avec --path. Vous pouvez simuler le remplacement ainsi :

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

Par défaut, WP-CLI traite les tables enregistrées pour cette installation ; vérifiez si une extension utilise d'autres tables avant d'élargir la portée. N'ajoutez pas toutes les tables de la base sans distinction si plusieurs applications y cohabitent.

Exécutez d'abord avec --dry-run pour simuler, puis sans cette option pour appliquer les modifications. WP-CLI respecte les données sérialisées ; --skip-columns=guid évite de modifier les identifiants permanents des contenus.