Migrer des utilisateurs WordPress avec WP-CLI demande d’abord de choisir entre deux opérations : ajouter des comptes dans un site existant, ou remplacer les tables utilisateurs d’une copie du même site. Les commandes se ressemblent peu, et leurs conséquences encore moins. Une sauvegarde n’est donc pas une option.
Choisir entre fusion de comptes et copie des tables
Sur un site qui possède déjà des utilisateurs, privilégiez un import applicatif. Il permet de créer ou rapprocher les comptes sans remplacer aveuglément leurs identifiants. L’import SQL des tables users et usermeta est réservé à une migration contrôlée, avec vérification de toutes les relations.
Les articles référencent notamment leurs auteurs par ID. Les commandes WooCommerce, abonnements et extensions peuvent également référencer des utilisateurs. Remplacer les comptes sans traiter ces références peut associer des données à la mauvaise personne.
Sauvegarder la source et la destination
Exécutez les commandes depuis chaque installation concernée. Stockez les fichiers hors du répertoire public, dans un dossier privé accessible uniquement au compte d’administration. L’exemple utilise un dossier situé dans son répertoire personnel.
umask 077
mkdir -p "$HOME/wp-user-migration"
wp db export "$HOME/wp-user-migration/avant-migration.sql"Langage du code : JavaScript (javascript)
Contrôlez le fichier obtenu et prévoyez une restauration testée. Pour une boutique active, définissez aussi comment traiter les inscriptions et commandes créées pendant l’opération. Voir le guide pour migrer WordPress avec WP-CLI et rsync.
Importer des comptes dans un site existant
Sur la source, exportez les champs nécessaires à l’import. Cette commande ne transfère ni les mots de passe, ni les métadonnées personnalisées, ni les abonnements.
wp user list --fields=user_login,user_email,display_name,roles --format=csv > "$HOME/wp-user-migration/utilisateurs-source.csv"Langage du code : PHP (php)
Préparez ensuite un fichier utilisateurs-import.csv avec les colonnes user_login,user_email,display_name,role. La colonne exportée roles doit être adaptée au champ role attendu à l’import. Vérifiez chaque rôle : ne transférez pas automatiquement des privilèges administrateur. Traitez séparément les comptes à plusieurs rôles.
user_login,user_email,display_name,role
lecteur_demo,lecteur@example.com,Lecteur de démonstration,subscriberLangage du code : CSS (css)
Testez sur une copie du site. Puis, sur la destination :
wp user import-csv "$HOME/wp-user-migration/utilisateurs-import.csv" --skip-updateLangage du code : JavaScript (javascript)
L’option --skip-update évite de mettre à jour un compte existant dont l’email ou le login correspond. Ce n’est pas une fusion automatique de toutes les données. Contrôlez les comptes ignorés et les doublons. N’ajoutez --send-email qu’après avoir décidé d’envoyer ces notifications.
Quand utiliser un export SQL des utilisateurs ?
Une copie SQL peut convenir pour déplacer le même site tout en conservant ses IDs, si sa destination est une copie cohérente et que les écritures sont arrêtées. Elle ne constitue pas une méthode générale pour fusionner deux sites.
Avant tout export, identifiez les tables réellement utilisées, leur préfixe et leur éventuel partage entre installations. Dans un réseau multisite, les rôles et capacités dépendent aussi des sites du réseau. Le simple changement de préfixe ne résout pas ces relations.
Un dump peut contenir des instructions qui suppriment ou recréent les tables. Inspectez-le avant tout wp db import. Ne publiez jamais le dump : il contient des données personnelles et peut contenir les empreintes de mots de passe.
Vérifier après migration
- Comparer le nombre de comptes et les erreurs d’import.
- Vérifier les rôles avec
wp user get LOGIN --field=roles. - Tester la connexion et le parcours de réinitialisation de mot de passe.
- Contrôler les auteurs des articles et les données clients ou abonnements.
- Supprimer les fichiers de transfert après validation, en conservant la sauvegarde selon votre politique de rétention.
Pour un problème d’accès après migration, consultez le diagnostic de connexion WordPress.

