Estendere Drupal 10 con Composer.

Learn DrupalAan de slag
Oggi è piuttosto comune che i moduli contribuiti di Drupal dipendano da librerie di terze parti. Alcuni di questi moduli si possono installare solo con Composer. Se hai già scaricato il core di Drupal con Composer, o se un modulo richiede Composer, usa Composer per scaricare tutti i moduli e i temi. Se mescoli aggiornamenti Composer con altri metodi, potresti incontrare problemi di aggiornamento piuttosto fastidiosi.
 

Scarica moduli e temi contribuiti con Composer

Vuoi scaricare moduli o temi contribuiti di Drupal con Composer? Ecco come:

  • Digita composer require drupal/module_name
  • Per esempio: composer require drupal/token
  • Assicurati di essere alla root dell’installazione Drupal

Composer aggiorna poi abilmente il tuo composer.json, aggiungendo il modulo all’elenco degli altri requisiti, così:

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

Composer scarica il modulo e ogni dipendenza che potrebbe avere.

Per attivare il modulo Drupal hai un paio di opzioni:

  • Usa l’interfaccia web standard di Drupal facendo clic su Estendi nella barra degli strumenti.
  • Prova uno strumento da riga di comando come Drush o Drupal Console: vedi Installing Modules from the Command Line.

Quando richiedi moduli, puoi usare il nome del progetto o il nome del modulo specifico dentro un progetto:

  • Composer scarica l’intero progetto che contiene un dato modulo.
  • Per esempio, se serve il modulo fe_block del progetto features_extra, puoi scegliere una delle due opzioni:
    • composer require drupal/features_extra
    • composer require drupal/fe_block
 

Scegliere una versione

Se vuoi specificare la versione del modulo o del tema da scaricare, fai così:

composer require 'drupal/module_name:version'

(Sostituisci version con la versione Composer effettiva o il vincolo di versione.)

Per esempio:

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'

Per evitare problemi su terminali o shell diversi, racchiudi la versione tra virgolette, come negli esempi qui sopra.

Attenzione! Su Windows, le virgolette (singole) possono rovinare la specifica della versione, con errore di installazione "Could not parse version constraint .....': Invalid version string "....'".

Senza virgolette, per esempio:

composer require drupal/dxpr_builder:^2.2

Oppure con virgolette doppie invece che singole, così:

composer require "drupal/dxpr_builder:^2.2"

Dovrebbe funzionare senza problemi. Per maggiori informazioni, vedi Comment 'Composer problems: "could not parse version constraint"'.

Negli esempi qui sopra, le versioni corrispondono come segue:

  • ^1.1: corrisponde all’ultima release stabile 10.x-1.x del modulo.
  • ~1.1: corrisponde all’ultima release stabile 10.x-3.x del modulo.
  • 2.2.2-alpha2: corrisponde alla versione 2.2.2-alpha2
  • 2.2.x-dev: corrisponde a 2.2.x-dev

Per maggiori informazioni sui vincoli di versione con ~ (tilde) e ^ (caret), vedi Next Significant Release Operators.

È una buona idea specificare la versione del modulo contribuito che vuoi scaricare.


Usare la ricerca di Composer

Buone notizie! Gli endpoint Composer di Drupal.org supportano la funzione di ricerca di Composer. Così puoi cercare progetti Drupal direttamente dalla riga di comando. Per usare la ricerca di Composer, digita:

composer search views
 

Usare la navigazione di Composer

Gli endpoint Composer di Drupal.org da Drupal 7 a 10 supportano anche la funzione di navigazione di Composer, per trovare maggiori informazioni sui progetti Drupal direttamente dalla riga di comando. Per usarla, digita:

composer browse drupal/token