Het is tegenwoordig heel normaal dat bijgedragen Drupal-modules gebruikmaken van bibliotheken van derden. Sommige van deze modules kunnen uitsluitend via Composer worden geïnstalleerd. Wanneer je Drupal core al met Composer hebt geïnstalleerd, of wanneer een module Composer vereist, is het belangrijk om Composer te gebruiken voor het beheer van alle modules en thema’s. Het combineren van Composer-updates met andere installatiemethoden kan namelijk leiden tot complexe en moeilijk op te lossen updateproblemen.

Bijgedragen modules en thema’s installeren met Composer

Wil je een bijgedragen Drupal-module of -thema downloaden met Composer? Volg dan deze stappen:

composer require drupal/module_name

Bijvoorbeeld:

composer require drupal/token

Zorg er altijd voor dat je dit commando uitvoert vanuit de rootmap van je Drupal-installatie.

Composer past vervolgens automatisch en op een intelligente manier het bestand composer.json aan. De module wordt toegevoegd aan de lijst met vereisten, bijvoorbeeld:

{
 "require": {
   "drupal/token": "^1.5"
 }
}

Daarna downloadt Composer de module samen met alle bijbehorende afhankelijkheden.

Drupal-modules inschakelen

Na het downloaden van de module kun je deze op verschillende manieren inschakelen:

Via de standaard Drupal-beheerinterface door in de werkbalk op Uitbreiden te klikken.
Via de opdrachtregel met hulpmiddelen zoals Drush of Drupal Console (zie: modules installeren via de command line).

Project- en modulenamen gebruiken

Bij het installeren van modules kun je zowel de projectnaam als de specifieke modulenaam binnen een project gebruiken:

Composer downloadt altijd het volledige project waar de module deel van uitmaakt.
Heb je bijvoorbeeld de module fe_block nodig uit het project features_extra, dan kun je één van de volgende commando’s gebruiken:

composer require drupal/features_extra
composer require drupal/fe_block

Een specifieke versie kiezen

Wil je een specifieke versie van een module of thema installeren, dan kun je dit expliciet aangeven:

composer require 'drupal/module_name:version'

(Vervang version door de gewenste Composer-versie of versiebeperking.)

Voorbeelden:

composer require 'drupal/dxpr_builder:^1.1'
composer require 'drupal/dxpr_builder:~1.1'
composer require 'drupal/dxpr_builder:2.2.2-alpha2'
composer require 'drupal/dxpr_builder:2.2.x-dev'

Om problemen met verschillende terminals of shells te voorkomen, is het aan te raden de versie altijd tussen aanhalingstekens te plaatsen, zoals in de bovenstaande voorbeelden.