文档Commerce工具

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

升级Data Migration Tool

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

创建对象：

  • 有经验的
  • 管理员
  • 开发人员

为确保当前Magento 2安装的版本与Data Migration Tool完全匹配，您可能需要升级该工具。

先决条件

升级Data Migration Tool之前，您必须：

  • 升级Magento软件以获取最新版本

  • 备份vendor/magento/data-migration-tool目录

  • 确保Data Migration Tool版本与Magento应用程序版本匹配

升级Magento软件

如果您尚未这样做，请升级Magento软件。

备份vendor/magento/data-migration-tool目录

在升级Data Migration Tool之前，请至少备份vendor/magento/data-migration-tool目录。 在升级期间，可以删除该代码并将其替换为更新的代码。

您还可以使用以下命令备份整个Magento代码库和数据库：

php <magento_root>/bin/magento setup:backup --code --db
WARNING
vendor/magento/data-migration-tool目录包含您的自定义代码。 无法备份它意味着在升级过程中可能会丢失自定义项。

确保版本匹配

Data Migration Tool和Magento软件的版本必须完全匹配。 例如，Magento 2.1.2需要Data Migration Tool的版本2.1.2。

请参阅安装 Data Migration Tool主题以了解如何：

  • 检查您的Magento 2版本

  • 查找的已发布版本Data Migration Tool

  • 检查 Data Migration Tool版本

升级Data Migration Tool

  1. 以文件系统所有者身份登录或切换到您的应用程序服务器。

  2. 切换到应用程序根目录。

  3. 输入以下命令：

    code language-bash 
    composer require magento/data-migration-tool:<version>

    其中<version>必须与Magento 2代码库的版本匹配。

    例如，对于版本2.1.2，输入：

    code language-bash 
    composer require magento/data-migration-tool:2.1.2

  4. 等待命令完成。

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