This plugin handles common operations for composer based Drupal setups. The code in this plugin is derived from the Drupal code base itself and also other projects such as drupal-composer/drupal-project.

The motive behind writing this plugin was to make a Drupal composer based setup more maintainable. It is easy to start with the template provided by drupal-composer/drupal-project but upgrading it is difficult. The plugin solves that problem by keeping all the code outside your project and in the plugin which would make upgrading as easy as running composer update.

If you are starting off a new Drupal 7 or 8 website, it is easier to start with the hussainweb/drupal-composer-init composer plugin. Follow the instructions there to install and use the command. The composer.json files generated include this plugin.

For existing composer setups, just run this command:

composer require hussainweb/drupal-composer-helper:~1.0

This plugin includes most of the functionality from drupal-composer template. That said, the plugin can be used in the template with some changes. The changes are not necessary to run the plugin but some operations could run twice.

Follow these steps to use the plugin in drupal-composer template:

• Include the plugin: composer require hussainweb/drupal-composer-helper:~1.0
• Remove 'DrupalProject\\composer\\ScriptHandler::createRequiredFiles' from post-install-cmd and post-update-cmd in scripts section of your composer.json. The plugin creates all necessary files.
• (Optional) After the above changes, you may remove scripts/composer/ScriptHandler.php file entirely (if you have not made any changes) and remove any references from the composer.json. There are some references in the autoload section, and also in pre-install-cmd and post-install-cmd scripts. This functionality is not present in the plugin but it is not really necessary as it is just a version check for composer.
• (Optional) If you have not changed any paths in installer-paths section from extra section in your composer.json, you may remove them. The plugin sets defaults which match the defaults set by the template. The paths in this section will take precedence over the plugin defaults.

The plugin provides following configuration options (and defaults) in composer.json file:

{
    ...
    "extra": {
        "drupal-composer-helper": {
            "web-prefix": "web",
            "additional-cleanup": [],
            "set-d7-paths": false
        },
        ...
    },
    ...

Default: 'web'

This sets the document root directory for the Drupal installation. The plugin uses this as a prefix to set all the Drupal relevant installer paths so that Drupal core, modules, and themes may be installed in the correct location. The plugin also runs scaffolding within this directory and creates other required files for Drupal.

For a Drupal 8 setup, the defaults set by this plugin are as follows:

'core': 'web/core/',
'module': 'web/modules/contrib/{$name}/',
'theme': 'web/themes/contrib/{$name}/',
'library': 'web/libraries/{$name}/',
'profile': 'web/profiles/contrib/{$name}/',
'drush': 'drush/{$name}/',
'custom-theme': 'web/themes/custom/{$name}/',
'custom-module': 'web/modules/custom/{$name}/',

The above are just defaults and can be overridden by the usual installer-paths property in extra section in your composer.json file.

See also: set-d7-paths.

Default: Empty array

This specifies a list of files or directories that should be deleted once composer install or update is complete. For example, you may use this to delete test directories from your production site.

Example:

{
    ...
    "extra": {
        "drupal-composer-helper": {
            "web-prefix": "web",
            "additional-cleanup": [
                "web/core/modules/system/tests",
                "web/core/tests",
                "web/modules/acquia_connector/src/Tests"
            ],
            "set-d7-paths": false
        },
        ...
    },
    ...

Default: false

Set this to true if you are building a Drupal 7 based site. This configuration option changes the default installer-paths paths to Drupal 7 typical paths.

If your web-prefix is docroot, the installer-paths set if this option is true are as follows.

'core': 'docroot/',
'module': 'docroot/sites/all/modules/contrib/{$name}/',
'theme': 'docroot/sites/all/themes/contrib/{$name}/',
'library': 'docroot/sites/all/libraries/{$name}/',
'profile': 'docroot/sites/all/profiles/contrib/{$name}/',
'drush': 'drush/{$name}/',
'custom-theme': 'docroot/sites/all/themes/custom/{$name}/',
'custom-module': 'docroot/sites/all/modules/custom/{$name}/',

Contributions are welcome. Please use the issue queue to describe the problem. Pull requests are welcome.