Tegenwoordig is het vrij gebruikelijk dat bijgedragen Drupal-modules vertrouwen op bibliotheken van derden. Sommige van deze modules kunnen alleen worden geïnstalleerd met Composer. Als je de Drupal core al hebt opgehaald met Composer, of als een module Composer vereist, moet je Composer gebruiken om al je modules en thema's te downloaden. Als u Composer-updates met andere methoden combineert en matcht, kunt u nogal lastige updateproblemen tegenkomen.

Pak bijgedragen modules en thema's met behulp van Composer

Dus, wil je bijgedragen Drupal-modules of thema's downloaden met Composer? Hier is hoe:

  • composer require drupal/module_name
  • Bijvoorbeeld: composer require drupal/token
  • Zorg ervoor dat u zich in de root van uw Drupal-installatie bevindt

Composer zal vervolgens uw composer.json op een slimme manier bijwerken en de module toevoegen aan de lijst met andere vereisten, zoals:

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

Composer downloadt de module en eventuele afhankelijkheden ervan.

Om de Drupal-module in te schakelen, heb je een aantal opties:

  • Gebruik de standaard Drupal-webbrowserinterface door op Uitbreiden in de werkbalk te klikken.
  • Probeer een opdrachtregelprogramma zoals Drush of Drupal Console - zie Modules installeren vanaf de opdrachtregel .

Wanneer u modules nodig heeft, kunt u de projectnaam of de specifieke modulenaam binnen een project gebruiken:

  • Componist downloadt het hele project dat een bepaalde module bevat.
  • Als u bijvoorbeeld de fe_block module uit het features_extra project nodig heeft, kunt u een van de volgende opties kiezen:
    • composer require drupal/features_extra
    • composer require drupal/fe_block

Een versie kiezen

Als je de versie wilt specificeren van de module of het thema dat je wilt downloaden, doe dat dan als volgt:

 composer require 'drupal/module_name:version'

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

Bijvoorbeeld:

 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 eventuele haperingen op verschillende terminals of shells te voorkomen, plaatst u de versie tussen aanhalingstekens, net als in de bovenstaande voorbeelden.

Let op! Op Windows kan het gebruik van (enkele) aanhalingstekens de versiespecificatie in de war brengen, waardoor de installatie mislukt met ' Kon versiebeperking niet parseren.....': Ongeldige versietekenreeks "....'" .

Zonder de aanhalingstekens bijvoorbeeld:

 composer require drupal/dxpr_builder:^2.2

Of gebruik dubbele aanhalingstekens in plaats van enkele aanhalingstekens, zoals zo:

 composer require "drupal/dxpr_builder:^2.2"

Het zou prima moeten werken. Voor meer informatie, zie Commentaar 'Problemen met de componist: "kan de versiebeperking niet parseren"' .

In de bovenstaande voorbeelden komen de versies als volgt overeen:

  • ^1.1: toegewezen aan de nieuwste stabiele 10.x-1.x-release van de module.
  • ~1.1: toegewezen aan de nieuwste stabiele 10.x-3.x-release van de module.
  • 2.2.2-alpha2: verwijst naar versie 2.2.2-alpha2
  • 2.2.x-dev: toegewezen aan 2.2.x-dev

Voor meer informatie over versiebeperkingen met ~ (tilde) en ^ (caret), kijk eens naar Next Significant Release Operators .

Het is een goed idee om de versie van de bijgedragen module die u wilt downloaden, op te geven.


Zoeken op componist gebruiken

Goed nieuws! De componist-eindpunten van Drupal.org ondersteunen de Composer-zoekfunctie . Dat betekent dat u rechtstreeks vanaf de opdrachtregel naar Drupal-projecten kunt zoeken. Om de zoekopdracht op componist te gebruiken, typt u:

 composer search views

Bladeren door Componist gebruiken

De componist-eindpunten van Drupal.org voor Drupal 7 tot en met 10 ondersteunen ook de Composer-bladerfunctie . Hierdoor kunt u direct vanaf de opdrachtregel aanvullende informatie over Drupal-projecten vinden. Om Composer browse te gebruiken, typt u:

 composer browse drupal/token