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

Paramètres de migration des données

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

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Le mode Settings migre les magasins, les sites web et la configuration du système comme les paramètres d’expédition, de paiement et de taxe. Selon notre ordre de migration des données, vous devez d’abord migrer les paramètres.

Avant de commencer, effectuez les étapes de préparation suivantes :

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

  2. Accédez au répertoire /bin ou assurez-vous qu’il est ajouté à votre PATH système.

NOTE
Assurez-vous que Magento 2 est déployé en mode default. Le mode Développeur peut entraîner des erreurs de validation dans l’outil de migration.

Voir la section premières étapes pour plus d’informations.

Exécutez la commande de migration des paramètres

Pour démarrer la migration des paramètres, exécutez :

bin/magento migrate:settings [-r|--reset] [-a|--auto] {<path to config.xml>}

Où :

  • [-r|--reset] est un argument facultatif qui lance la migration depuis le début. Vous pouvez utiliser cet argument pour tester la migration

  • [-a|--auto] est un argument facultatif qui empêche l’arrêt de la migration lorsqu’elle rencontre des erreurs de contrôle d’intégrité.

  • {<path to config.xml>} est le chemin d’accès absolu au fichier config.xml de l’outil de migration ; cet argument est obligatoire.

NOTE
Cette commande ne migre pas tous les paramètres de configuration. Vérifiez tous les paramètres d’administration de Magento 2 avant de continuer.

Le message Migration completed s’affiche une fois les paramètres transférés avec succès.

Configuration de règles de migration personnalisées

Vous pouvez ignorer, renommer ou modifier les configurations système lors de la migration des paramètres. Pour ce faire, spécifiez vos règles personnalisées dans le fichier settings.xml.

  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 suivant :

    code language-bash 
    cd <your application 2 install dir>/vendor/magento/data-migration-tool/etc/<edition-to-edition>

    Par exemple, si l'application est installée dans /var/www/html, le fichier settings.xml.dist se trouve dans l'un des répertoires suivants :

    • /var/www/html/vendor/magento/data-migration-tool/etc/opensource-to-commerce

    • /var/www/html/vendor/magento/data-migration-tool/etc/commerce-to-commerce

    • /var/www/html/vendor/magento/data-migration-tool/etc/opensource-to-opensource

  3. Pour créer un fichier settings.xml à partir de l’exemple fourni, exécutez :

    code language-bash 
    cp settings.xml.dist settings.xml

  4. Apportez vos modifications dans settings.xml.

  5. Pour spécifier le nouveau nom du fichier de paramètres à mapper, modifiez la balise <settings_map_file> dans le fichier path/to/config.xml.

Pour plus d’informations, consultez la section Mode de migration des paramètres de la spécification de l’outil.

Étape de migration suivante

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