文件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需要2.1.2版的Data Migration Tool。

請參閱安裝 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