[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Mettre à niveau le Data Migration Tool

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Configuration

Créé pour :

Expérimenté
Administration
Développeur

Pour vous assurer que les versions de votre installation Magento 2 actuelle et de la Data Migration Tool correspondent exactement, vous devrez peut-être mettre à niveau l’outil.

Conditions préalables

Avant de mettre à niveau le Data Migration Tool, vous devez :

Mettez à niveau votre logiciel Magento pour obtenir la dernière version
Sauvegarde du répertoire vendor/magento/data-migration-tool
Vérifiez que la version Data Migration Tool correspond à la version de l’application Magento

Mettre à niveau votre logiciel Magento

Si ce n’est pas déjà fait, mettez à niveau le logiciel Magento.

Sauvegarde du répertoire `vendor/magento/data-migration-tool`

Avant de mettre à niveau le Data Migration Tool, sauvegardez au moins le répertoire vendor/magento/data-migration-tool. Pendant la mise à niveau, il peut être supprimé et remplacé par le code mis à jour.

Vous pouvez également sauvegarder l’intégralité de la base de code et de la base de données Magento à l’aide de la commande suivante :

php <magento_root>/bin/magento setup:backup --code --db

WARNING

Le répertoire vendor/magento/data-migration-tool contient votre code personnalisé. Si vous ne le sauvegardez pas, vous risquez de perdre vos personnalisations lors de la mise à niveau.

Vérifiez que les versions correspondent.

Les versions du Data Migration Tool et de votre logiciel Magento doivent correspondre exactement. Par exemple, Magento 2.1.2 nécessite la version 2.1.2 du Data Migration Tool.

Voir la rubrique Installer Data Migration Tool pour savoir comment :

Vérifier votre version de Magento 2
Rechercher versions publiées du Data Migration Tool
Vérifier la version Data Migration Tool