Objectif
Utiliser Composer pour télécharger et mettre à jour les fichiers et les dépendances du cœur (core) ou des modules et thèmes contribués.
Prérequis
Section 3.2, « Concept : outils supplémentaires »
Prérequis du site
Si vous voulez utiliser Composer, il doit être installé, soit sur votre serveur de développement local, soit sur votre site en production. Consulter Section 3.2, « Concept : outils supplémentaires ».
Étapes
Si vous n’êtes pas en mesure d’installer l’outil Composer sur votre serveur de production, vous pouvez suivre les étapes dans n’importe laquelle des sections ci-dessous sur votre serveur local, et ensuite transférer tout fichier ajouté ou mis à jour sur votre serveur de production. La procédure recommandée est de faire une archive ou un fichier zip des nouveaux répertoires ou des répertoires modifiés que vous tranférerez sur votre serveur de production, d’y supprimer les répertoires qui ont été modifiés, et d’extraire l’archive. Inspecter les modifications et ajouts aux fichiers suivants, à la racine de votre installation :
- répertoire vendor
- autoload.php
- composer.json
- composer.lock
Utiliser Composer pour télécharger le cœur (core)
Suivre ces étapes si vous n’avez pas encore téléchargé ou installé le cœur, et que vous voulez utiliser Composer pour télécharger à la fois le cœur et ses dépendances externes :
- Dans la ligne de commande, se placer un niveau au-dessus du répertoire où vous souhaitez que se trouve le logiciel.
Saisir cette commande, où monrépertoire est le répertoire que vous souhaitez créer :
composer create-project drupal/recommended-project monrépertoire
- La dernière version du cœur sera téléchargée dans le sous-répertoire monrépertoire/web.
Utiliser Composer pour télécharger un module ou un thème
Suivre ces étapes si vous utilisez déjà Composer pour gérer le cœur, et que vous voulez utiliser Composer pour ajouter un module ou thème contribué avec ses dépendances.
- Chaque fois que vous voulez ajouter un module ou thème contribué, déterminer le nom court du projet. Il s’agit de la dernière partie de l’URL de la page du projet ; par exemple le module Geofield, à l’adresse https://www.drupal.org/project/geofield, a pour nom court
geofield. Pour télécharger le module ou thème contribué avec ses dépendances externes, saisir la commande suivante à la racine de votre site (en remplaçant
geofieldpar le nom court du module ou du thème) :composer require drupal/geofield
Utiliser Composer pour mettre à jour des fichiers précédemment téléchargés
Suivre ces étapes pour mettre à jour les fichiers du cœur ou d’un thème ou module contribué, après avoir commencé à gérer les dépendances avec Composer :
- Déterminer le nom court du projet que vous voulez mettre à jour. Pour le cœur, il s’agit de core. Pour des modules ou thèmes contribués, il s’agit de la dernière partie de l’URL de la page du projet ; par exemple le module Geofield, à l’adresse https://www.drupal.org/project/geofield, a pour nom court
geofield. Si vous voulez mettre à jour vers la dernière version stable, utiliser la commande suivante, en remplaçant
geofieldpar le nom court du projet à mettre à jour :composer update drupal/geofield --with-dependencies
S’il vous faut une version spécifique, déterminer comment saisir le numéro de version vers lequel vous voulez mettre à jour. Par exemple, pour la version 8.x-1.16 d’un module contribué, vous saisiriez juste 1.16, tandis que pour la version 9.0.7 du cœur, vous saisiriez 9.0.7. Saisir ensuite la commande suivante à la racine de votre site (en remplaçant
geofieldpar le nom court du projet et en indiquant le bon numéro de version) :composer require drupal/geofield:1.16
Améliorer votre compréhension
Vous pouvez en apprendre plus sur les commandes de Composer en utilisant son sytème d’aide intégré. Par exemple, pour en savoir plus sur la commande create-project, saisir composer help create-project dans votre invite de commande.
Pour aller plus loin (en anglais)
Attributions
Adapté par Jennifer Hodgdon, Hans Fredrik Nordhaug, et Joe Shindelar de Drupalize.Me à partir de "Using Composer to manage Drupal site dependencies", copyright 2000-2025 contributeurs individuels à la documentation de la communauté de Drupal. Traduit par Felip Manyer i Ballester.
