DocumentationCommerceOutils

[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."}

Installation du Data Migration Tool

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

Créé pour :

  • Expérimenté
  • Administration
  • Développeur
INFO
Les versions de Magento et de Data Migration Tool doivent correspondre.

Assurez-vous d’utiliser la même version publiée de Magento 2 et de la Data Migration Tool. Par exemple, pour la version 2.2.0 de Magento, vous devez également utiliser la version 2.2.0 de Data Migration Tool.

Vérifier votre version

Utilisez l’une des méthodes suivantes pour vérifier votre version de Magento :

Métapaquet du compositeur

Si vous avez téléchargé le logiciel Magento à l’aide d’un métapaquet Composer, saisissez la commande suivante :

php <magento_root>/bin/magento --version

Référentiel GitHub

Si vous avez cloné le référentiel GitHub de Magento 2, saisissez les commandes suivantes :

cd <your Magento 2 clone directory>

git branch

Si vous vous trouvez actuellement dans la branche develop, vous devez passer à une branche publiée avant de continuer.

Si vous n’avez pas encore installé le logiciel Adobe Commerce, installez-le maintenant.
Si vous clonez le référentiel GitHub, veillez à extraire une balise de version, comme indiqué dans la section (Contributeur) Cloner le référentiel GitHub.

Rechercher les versions publiées de Data Migration Tool

Accédez à la page Versions du référentiel GitHub Data Migration Tool pour trouver les versions publiées disponibles.

Installation du Data Migration Tool

Vous pouvez installer le Data Migration Tool à partir de :

Avant l’installation, vérifiez que vous disposez des éléments suivants :

Installer à partir de repo.magento.com

Pour installer le Data Migration Tool, vous devez mettre à jour composer.json dans le répertoire d’installation racine de Magento afin de fournir l’emplacement du package Data Migration Tool.

  1. Connectez-vous au serveur d’applications en tant que propriétaire du système de fichiers ou passez à ce serveur.

  2. Accédez au répertoire racine de l’application.

  3. Saisissez les commandes suivantes :

    code language-bash 
    composer config repositories.magento composer https://repo.magento.com
    code language-bash 
    composer require magento/data-migration-tool:<version>

    Où <version> doit correspondre à la version de la base de code Magento 2.

    Par exemple, pour la version 2.2.0, saisissez :

    code language-bash 
    composer config repositories.magento composer https://repo.magento.com
    code language-bash 
    composer require magento/data-migration-tool:2.2.0

  4. A l’invite, saisissez vos clés d’authentification. Votre clé publique est votre nom d'utilisateur ; votre clé privée est votre mot de passe.

Installer à partir de GitHub

Si vous avez cloné le référentiel GitHub, suivez les étapes ci-dessous pour installer le Data Migration Tool.

  1. Connectez-vous au serveur d’applications en tant que propriétaire du système de fichiers ou passez à ce serveur.

  2. Accédez au répertoire racine de l’application.

  3. Saisissez les commandes suivantes :

    code language-bash 
    composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool
    code language-bash 
    composer require magento/data-migration-tool:<version>

    où <version> doit correspondre à la version de la base de code Magento 2.

    Par exemple, pour la version 2.2.0, saisissez :

    code language-bash 
    composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool
    code language-bash 
    composer require magento/data-migration-tool:2.2.0

Vérification de la version des Data Migration Tool installés

  1. Modifiez votre répertoire Data Migration Tool : <vendor>/magento/data-migration-tool.

  2. Ouvrez composer.json dans un éditeur de texte.

  3. L’entrée version de ce fichier correspond à la version du Data Migration Tool.

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3