INTRODUCTION

Drupal Module Upgrader(https://www.drupal.org/project/drupalmoduleupgrader) is a script that scans the source of a Drupal 7 module, flags any code that requires updating to Drupal 8, points off to any relevant API change notices from https://www.drupal.org/list-changes/, and (where possible) will actually attempt to convert the Drupal 7 code automatically to the Drupal 8 version!

Steps to follow

• Place the Drupal 7 module you wish to port into your Drupal 8 site's /modules directory.
• To scan the 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 print a report showing any relevant change notices where you can read more.
• To attempt to upgrade your Drupal 7 module's code to Drupal 8 it automatically run the following command inside the Drupal 8 root directory:

  drush dmu-upgrade MODULE_NAME

  The script result will output a few lines as it execute various conversions. Go into your modules/MODULE_NAME directory and check out all of your new YAML files and such.
• To clear out D7 code that has been converted, run the clean command:

  drush dmu-clean MODULE_NAME

  This will do things like delete old .info files and such, so you're closer to your port being completed!

REQUIREMENTS

Drupal Upgrade module requires the following dependencies:

Composer (https://getcomposer.org) Drush 7+ (https://github.com/drush-ops/drush) Pharborist (https://github.com/grom358/pharborist) Symfony Yaml Component (https://github.com/symfony/Yaml) Note that most dependencies are automatically downloaded by Composer during installation.

INSTALLATION

• Download and install Composer: https://getcomposer.org/doc/00-intro.md#system-requirements
• Download and install the latest version of Drush: https://github.com/drush-ops/drush#installupdate---composer
• Download and install the latest Drupal 8:

  git clone --branch 8.0.x http://git.drupal.org/project/drupal.git 8.x

• Download the latest release of drupalmoduleupgrader to your Drupal 8 site’s /modules directory:

  drush dl drupalmoduleupgrader

• Run `composer install` from the drupalmoduleupgrader directory:

  cd drupalmoduleupgrader

  composer install

  You should see output as it downloads various dependencies (pharborist, phpcs, yaml...)
• Finally, enable the module:

  drush en drupalmoduleupgrader -y

TROUBLESHOOTING

If you are getting any errors, check the following first: - Are you using the very latest Drupal 8 code? From the 8.x root directory, do:

 git pull --rebase

- Are you using the very latest drupalmoduleupgrader code (and dependencies' code)? From the drupalmoduleupgrader root directory:

       git pull --rebase
       composer update
       drush pm-uninstall drupalmoduleupgrader -y
       drush en drupalmoduleupgrader
       

RUNNING TESTS

Drupal Module Upgrader uses Composer to install its dependencies inside the module folder. Since it operates as a standalone project this is perfectly fine. However if we want to run the tests we have to use a different strategy. Drupal core itself also uses Composer, and it manages its dependencies and namespaces inside the core/vendor/ folder. It is unaware of DMU's dependencies and the tests will fail. We can use Composer Manager [1] to generate a new composer.json file in the root of the Drupal site. This will combine the dependencies of Drupal core and all contributed and custom projects.

• Navigate to the root folder of your Drupal installation:

   cd /path/to/drupal/site/

• Download Composer Manager:

  drush dl composer_manager

• Initialize Composer Manager:

   php modules/composer_manager/scripts/init.php

• Install the combined dependencies of Drupal core and modules:

  composer drupal-install

• Run the tests:

   ./vendor/bin/phpunit -c core --group=DMU