Drupal 7 to 8/9/10 Module Upgrader

This project is a command-line tool that should be run on your Drupal 8 or 9 site on the yet unported Drupal 7 modules in the codebase. It scans the source of a Drupal 7 module, flags any code that requires updating to Drupal 8/9, points off to any relevant API change notices, and (where possible) will actually attempt to convert the Drupal 7 code automatically to the Drupal 8/9 version!

Read the whole documentation at https://www.drupal.org/documentation/modules/drupalmoduleupgrader including tips on how to write new rules.

Installation

See README.txt for installation and set up instructions.

• Installing this tool requires Composer.
• The "minimum-stability" option in the site's composer.json file must be set to "dev".
• Run the following command from somewhere in the site's codebase:
  composer require drupal/drupalmoduleupgrader
• Install the module like you would any other Drupal module (using the Extend page or Drush).

Usage

1. Place the Drupal 7 module you wish to port into your Drupal 8/9 site's /modules directory.
2. To scan code and get a report of code that needs updating and how, run the following inside the Drupal 8 root directory:
   

   drush dmu-analyze MODULE_NAME
   

   This will export a report showing any relevant change notices where you can
   read more.

3. To attempt to upgrade your Drupal 7 module's code to Drupal 8/9 automatically,
   run the following inside the Drupal 8/9 root directory:

   drush dmu-upgrade MODULE_NAME
   

   The script will output a few lines as it attempts various conversions. Go into your modules/MODULE_NAME directory and check out all of your new YAML files and such. ;)

Drupal 9 compatibility

The existing transformations should be Drupal 9 compatible as well, so you can go in one fell swoop from Drupal 7 to Drupal 9. The APIs that do not have transformations will still stay with their Drupal 7 code, full coverage is definitely not guaranteed.

Drupal 10 compatibility

The transformations have not yet been reviewed for Drupal 10 compatibilty. See Make module upgrader transformations compatible with Drupal 10