Advertising sustains the DA. Ads are hidden for members. Join today

On this page

3.5. Utiliser Composer pour télécharger et mettre à jour les fichiers

Last updated on
14 April 2025

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 :

  1. Dans la ligne de commande, se placer un niveau au-dessus du répertoire où vous souhaitez que se trouve le logiciel.

  2. Saisir cette commande, où monrépertoire est le répertoire que vous souhaitez créer : 

    composer create-project drupal/recommended-project monrépertoire
  3. 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.

  1. 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.

  2. 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 geofield par 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 :

  1. 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.

  2. Si vous voulez mettre à jour vers la dernière version stable, utiliser la commande suivante, en remplaçant geofield par le nom court du projet à mettre à jour : 

    composer update drupal/geofield --with-dependencies

  3. 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 geofield par 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.

Vidéos

Using Composer and Git to Download Files

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.

 

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: install-composer.asciidoc

Help improve this page

Page status: No known problems

You can: