13.6. Mettre à jour un module
- Un module contribué a été installé et une mise à jour est disponible pour lui. Consulter Section 11.3, « Télécharger et installer un module depuis Drupal.org » et Section 13.4, « Rester informé des mises à jour ».
- Si votre site est en ligne, vous devriez tester ce processus dans un environnement de développement avant de l’exécuter sur votre site en production. Consulter Section 11.8, « Mettre en place un site de développement ».
- Vous avez créé une sauvegarde complète du site. Consulter Section 12.3, « Concept : sauvegarde de données ».
- Si vous souhaitez utiliser l’interface utilisateur pour vérifier la présence de mises à jour, le module Update Manager du cœur doit être installé. Voir Section 4.3, « Installer un module » pour des instructions sur l’installation de modules du cœur.
Avant de commencer, vérifier les instructions de mise à jour propres au module. Lisez et assurez-vous de comprendre tous les prérequis propres au module avant de procéder aux mises à jour. Pour trouver des instructions, consulter le lien Lire la documentation de la page du projet du module.
Pour consulter des instructions supplémentaires, après avoir téléchargé les fichiers mis à jour, consulter les fichiers README.txt, INSTALL.txt et UPGRADE.txt fournis avec les fichiers d’installation du module. Consulter également les notes de version sur la page du projet en cliquant sur le numéro de la version que vous téléchargez.
Mettre à jour un module suppose de mettre d’abord le site en mode de maintenance, d’obtenir les nouveaux fichiers de code, d’appliquer les mises à jour de la base requises, et enfin de sortir le site du mode de maintenance.
Vous pouvez mettre le code d’un module contribué à jour en utilisant Composer. Si vous utilisez un module personnalisé plutôt qu’un module contribué, récupérer les nouveaux fichiers du module, puis poursuivre les instructions relatives aux mises à jour de la base par l’interface d’administration ci-dessous.
Cela suppose que vous utilisez Composer pour gérer les fichiers de votre site ; consulter Section 3.5, « Utiliser Composer pour télécharger et mettre à jour les fichiers ».
- Mettre votre site en mode de maintenance. Consulter Section 11.2, « Activer et désactiver le mode maintenance ».
- Dans le menu d’administration Gérer, naviguer vers Rapports > Mises à jour disponibles > Mettre à jour (admin/reports/updates/updates).
Rechercher et vérifier le module dans la liste. Cliquer sur Télécharger ces mises à jour après avoir sélectionné le module.
-
Déterminer le nom machine du projet que vous voulez mettre à jour. Pour les
modules contribués et les thèmes, il s’agit de la dernière partie de l’URL de la
page du projet ; par exemple, pour le module Geofield, à l’adresse
https://www.drupal.org/project/geofield, le nom machine est
geofield. Si vous voulez mettre à jour vers la dernière version stable, utiliser la commande suivante, en remplaçant le nom machine du projet à mettre à jour :
composer update drupal/geofield --with-dependencies
+ Pour apprendre comment télécharger une version spécifique, consulter Section 3.5, « Utiliser Composer pour télécharger et mettre à jour les fichiers ».
- Après avoir obtenu les nouveaux fichiers du module, ouvrir la page des mises à jour de la base en tapant l’URL example.com/update.php dans votre navigateur.
- Cliquer sur Continuer pour lancer les mises à jour. Les scripts de mise à jour de la base seront lancés.
- Cliquer sur Pages d’administration pour retourner à la section d’administration de votre site.
- Sortir votre site du mode de maintenance. Consulter Section 11.2, « Activer et désactiver le mode maintenance ».
- Vider le cache (se référer à Section 12.2, « Vider le cache »).
- Une fois les mises à jour terminées, consulter le journal du site (se référer à Section 12.4, « Concept : journal ») pour vérifier s’il y a des erreurs.
- Section 13.7, « Mettre un thème à jour »
Attributions
Adapté par Boris Doesborgh, Sarah German de Advomatic et Joe Shindelar de Drupalize.Me à partir de "Update modules", copyright 2000-2025 contributeurs individuels à la documentation de la communauté Drupal. Traduit par Thierry Jarrige, Édouard Cunibil, Francis Pomliane et Felip Manyer i Ballester.
Source file: security-update-module.asciidoc
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion
