Presentation at Imagine 2016.

2. Manager, Product Management
Magento Inc.
Elena Leonova
Magento 1.x to Magento 2
Code Migration Tool
Architect, Expert Consulting Group
Magento Inc.
Sergii Shymko

3. Magento 2 Upgrade Scope
Database
Schema
Data
Codebase
Magento framework
3rd party extensions
Custom modules
Custom themes
@SergiiShymko

4. Magento 2 Upgrade Tooling
Database
Schema
Data
Codebase
Magento framework
3rd party extensions
Custom modules
Custom themes
Data migration tool
github.com/magento/data-migration-tool
Code migration tool
github.com/magento/code-migration
@SergiiShymko

5. Code Migration Tool Scope
Configuration
<?php // code ;)
Layout
Magento
module
@SergiiShymko
Directory
structure

6. Code Migration Tool Overview
• Audience: Magento developers
• Interface: Command line interface (CLI)
• Goal: Automate routine code changes
• Methodology: Static code analysis
• Remaining work: Manual testing, troubleshooting, fixing
Code migration tool
Magento 1.x
source code
Magento 2
source code
@SergiiShymko

7. Prerequisite Directories
<tool> – Installed code migration tool
<src> – Custom Magento 1.x code to be migrated
<dst> – Empty directory to put generated Magento 2 code to
<m1> – Vanilla Magento 1.x codebase + <src> + dependencies
<m2> – Vanilla Magento 2 codebase
@SergiiShymko

8. Directory Utilization
Code migration tool<src> <dst>
<m1> <m2>
@SergiiShymko

9. Directory Utilization
Code migration tool<src> <dst>
<m1> <m2>
@SergiiShymko

10. Migration Sequence
Generate
mappings
Migrate
directory
structure
Migrate
layout
Migrate
config
Migrate
PHP code
1. 2. 3. 4. 5.
@SergiiShymko

11. Command to run:
1. Mapping Generation
• Mapping between Magento 1.x and Magento 2:
– Latest releases – out of the box
– Any versions – generated on demand
• Mapping covers:
– Module names
– Class names & dependencies
– Table names
– View files
php <tool>/bin/utils.php generateClassMapping <m1> <m2>
@SergiiShymko
Magento 1.x Magento 2
Mage_Catalog Magento_Catalog
Enterprise_Catalog Magento_AdvancedCatalog
… …

12. Command to run:
2. Directory Structure Migration
• Removal of code pools: core, community, local
• Aggregation of module’s files in a single directory:
– PHP code
– Templates
– Layouts
– Static assets
– Translation dictionaries
php <tool>/bin/migrate.php migrateModuleStructure <src> <dst>
@SergiiShymko

13. Magento 1.x Magento 2
2. Directory Structure Migration
app/
code/
community/
Example/Module/
etc/modules/
locale/<locale>/
design/
<area>/base/default/
skin/
<area>/base/default/
app/
code/
Example/Module/
etc/
i18n/<locale>/
view/<area>/
@SergiiShymko

14. Command to run:
3. Layout Migration
• Breaking down layout files by handles
• Format of layout XML files:
– Block types
– Block names
– Template references
– References to blocks and containers
– Adding JS/CSS assets to page head
php <tool>/bin/migrate.php convertLayout <dst>
@SergiiShymko

15. Magento 1.x Magento 2
3. Layout Migration
app/
design/
frontend/
base/default/
layout/
example.xml
app/
code/
Example/Module/
view/
frontend/
layout/
default.xml
…
@SergiiShymko

16. Command to run:
4. Configuration Migration
• Breaking down config.xml into granular configs
• Format of config XML files:
– Module declaration
– Routers
– Indexers
– Admin menu
– System configuration
– Widgets
php <tool>/bin/migrate.php convertConfig <dst>
@SergiiShymko

17. Magento 1.x Magento 2
4. Configuration Migration
app/
code/community/
Example/Module/
etc/
config.xml
app/
code/
Example/Module/
etc/[<area>/]
module.xml
…
…
@SergiiShymko

18. Command to run:
5. PHP Code Migration
• Breaking down controllers by actions
• Format of PHP files:
– Class namespaces
– Dependency injection via constructor
– Class name aliases in factory methods
– Class names in static calls, constants, arguments, operator “new”, PHPDoc
– Table name aliases
– Translation via “gettext”
php <tool>/bin/migrate.php convertPhpCode <dst> <m1> <m2>
@SergiiShymko

19. 5. PHP Code Migration
@SergiiShymko

20. Tool Commands Summary
1. Generate mappings
2. Migrate directory structure
3. Migrate layout
4. Migrate configuration
5. Migrate PHP code
php <tool>/bin/migrate.php migrateModuleStructure <src> <dst>
php <tool>/bin/migrate.php convertLayout <dst>
php <tool>/bin/migrate.php convertConfig <dst>
php <tool>/bin/migrate.php convertPhpCode <dst> <m1> <m2>
php <tool>/bin/utils.php generateClassMapping <m1> <m2>
@SergiiShymko

21. a. Commit disabled Magento 2 modules
b. Test, fix, and enable module by module
3. Magento 2 codebase tasks
Code Upgrade Project Breakdown
2. Code migration tool tasks
a. Tailor the tool for patterns unique to the project
b. Run the tool against Magento 1.x codebase
1. Magento 1.x codebase tasks
a. Remove unused modules
b. Revert modifications of core files ]:->
c. Remove fixes of bugs irrelevant in Magento 2
@SergiiShymko

22. Q & A
Thank You!
Elena Leonova
eleonova@magento.com
github.com/magento/code-migration
github.com/magento/data-migration-tool
devdocs.magento.com/guides/v2.0/migration/migration-tool.html
Sergii Shymko
sshymko@magento.com