Composer

Composer is een PHP dependency manager, zoiets als "Drush voor PHP". Drupal Commerce 2.x kun je uitsluitend via Composer installeren, omdat de hoeveelheid afhankelijkheden handmatige installatie te complex maakt.

Wat de Composer introduction-pagina ervan vindt:

Composer is not a package manager in the same sense as Yum or Apt are. Yes, it deals with "packages" or libraries, but it manages
them on a per-project basis, installing them in a directory (e.g. vendor) inside your project. By default it does not install 
anything globally. Thus, it is a dependency manager. It does however support a "global" project for convenience via the global 
command.

This idea is not new and Composer is strongly inspired by node's npm and ruby's bundler.

Suppose:

* You have a project that depends on a number of libraries.
* Some of those libraries depend on other libraries.

Composer:

* Enables you to declare the libraries you depend on.
* Finds out which versions of which packages can and need to be installed, and installs them (meaning it downloads them into your project).

Installatie

• Composer is in PHP geschreven. Installatie gaat op een manier die gebruikelijk is voor PHP-projecten (geloof ik)
• De 'executable' is uiteindelijk slechts één bestand: composer.phar, of afgekort tot composer
• In eerste aanleg installeer je Composer per project, in de root van het betreffende project. Je kunt Composer ook globaal installeren. Ik heb de indruk dat dat voor de verdere werking weinig verschil maakt

Apt-get werkt niet

sudo apt-get install werkt niet (begin 2017), omdat ik daarmee een te oude versie krijg. Wat wel werkt:

Globale installatie

/usr/local/bin is een gebruikelijke locatie voor eigen programmatuur.

sudo mkdir /usr/local/bin/composer
cd /usr/local/bin/composer
curl -sS https://getcomposer.org/installer | php

In .bashrc de PATH-variabele uitbreiden, bv. met PATH=/usr/local/bin/composer:$PATH en source ~/.bashrc

Waarschijnlijk doet dit hetzelfde als het script dat in de officiele documentatie wordt genoemd.

Bijwerken (algemeen)

Waarschijnlijk werk je 'm bij door 'm opnieuw te installeren: Het bestaat uit één PHP-bestand, dus er is effectief geen installatie-procedure (anders dan eventueel aanpassen PATH-variabele).

Voorbeeld: Een bibliotheek installeren

• Maak projectmap aan ComposerTest

Installatie van libraries voor Drupal

Voorbeeld:

cd /modules/commerce
composer install

Composer leest vervolgens het bestand composer.json en ziet dat er drie libraries benodigd zijn, en installeert ze:

commerceguys/intl library
commerceguys/tax library
commerceguys/addressing library

Vervolgens wordt het composer.lock-bestand weggeschrijven. Deze beschrijft de specifieke versies van de betreffende libraries. Altijd handig om versie-conflicten te vermijden.

Zie ook

• Drupal Commerce 2.x - Installatie
• Drush 8 installatie

Bronnen

• https://getcomposer.org
• https://getcomposer.org/doc/01-basic-usage.md - Goede handleiding!
• http://crossfunctional.net/blog/2013/may/indefinitive-guide-composer-drupal-8
• https://drupalize.me/blog/201408/upgrading-drush-work-drupal-8

Video's Lamin Sanneh

• PHP Composer Tutorial - 1 Installing and setting up composer part 1
• PHP Composer Tutorial - 2 Installing and setting up composer part 2
• PHP Composer Tutorial - 3 Installing and setting up composer part 3
• Etc.