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:
This will print a report showing any relevant change notices where you can read more.drush dmu-analyze MODULE_NAME - 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:
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.drush dmu-upgrade MODULE_NAME - To clear out D7 code that has been converted, run the clean command:
This will do things like delete old .info files and such, so you're closer to your port being completed!drush dmu-clean MODULE_NAME
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
You should see output as it downloads various dependencies (pharborist, phpcs, yaml...)composer install - 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
