DocumentationCommerceGuide d’installation

Désinstallation des modules

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cette section explique comment désinstaller un ou plusieurs modules. Lors de la désinstallation, vous pouvez éventuellement supprimer le code des modules, le schéma de base de données et les données de base de données. Vous pouvez d’abord créer des sauvegardes afin de récupérer les données ultérieurement.

Vous ne devez désinstaller un module que si vous êtes certain de ne pas l’utiliser. Au lieu de désinstaller un module, vous pouvez le désactiver comme décrit dans la section Activer ou désactiver les modules.

NOTE
Cette commande vérifie que seules les dépendances déclarées dans le fichier composer.json. Si vous désinstallez un module et non défini dans le fichier composer.json, cette commande désinstalle le module sans vérifier les dépendances. Cette commande ne not, cependant, supprime le code du module du système de fichiers. Vous devez utiliser les outils du système de fichiers pour supprimer le code du module (par exemple, rm -rf <path to module>). Vous pouvez également désactiver les modules non compositeur.

Utilisation des commandes :

bin/magento module:uninstall [--backup-code] [--backup-media] [--backup-db] [-r|--remove-data] [-c|--clear-static-content] \
  {ModuleName} ... {ModuleName}

Où {ModuleName} spécifie le nom du module au format <VendorName>_<ModuleName>. Par exemple, le nom du module client est Magento_Customer. Pour obtenir une liste des noms de module, saisissez magento module:status

La commande de désinstallation du module effectue les tâches suivantes :

  1. Vérifie que les modules spécifiés existent dans la base de code et sont des modules installés par le compositeur.

    Cette commande fonctionne uniquement avec des modules définis comme des packages de compositeur.

  2. Vérifie les dépendances avec d’autres modules et termine la commande s’il existe des dépendances non satisfaites.

    Pour contourner ce problème, vous pouvez soit désinstaller tous les modules en même temps, soit désinstaller les modules dépendants en premier.

  3. Demande une confirmation.

  4. Met le magasin en mode de maintenance.

  5. Traite les options de commande suivantes.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Option Signification Nom et emplacement du fichier de sauvegarde
    --backup-code Sauvegarde le système de fichiers (à l’exclusion des répertoires var et pub/static). var/backups/<timestamp>_filesystem.tgz
    --backup-media Sauvegarde le répertoire pub/media. var/backups/<timestamp>_filesystem_media.tgz
    --backup-db Sauvegarde la base de données. var/backups/<timestamp>_db.gz

  6. Si --remove-data est spécifié, supprimez le schéma de base de données et les données définis dans les classes Uninstall du module.

    Pour chaque module spécifié à désinstaller, appelle la méthode uninstall dans sa classe Uninstall. Cette classe doit hériter de Magento\Framework\Setup\UninstallInterface.

  7. Supprime les modules spécifiés de la table de base de données setup_module.

  8. Supprime les modules spécifiés de la liste des modules dans la configuration de déploiement.

  9. Supprime le code de la base de code à l’aide de composer remove.

    note note
    NOTE
    La désinstallation d'un module always s'exécute composer remove. L’option --remove-data supprime les données de la base de données et le schéma définis par la classe Uninstall du module.

  10. Nettoie le cache.

  11. Met à jour les classes générées.

  12. Si --clear-static-content est spécifié, nettoie les fichiers de vue statique générés.

  13. Supprime le magasin hors mode de maintenance.

Par exemple, si vous tentez de désinstaller un module dont dépend un autre module, le message suivant s’affiche :

magento module:uninstall Magento_SampleMinimal
    Cannot uninstall module 'Magento_SampleMinimal' because the following module(s) depend on it:
        Magento_SampleModifyContent

Une alternative consiste à désinstaller les deux modules après la sauvegarde du système de fichiers du module, des fichiers pub/media et des tables de base de données, mais non en supprimant le schéma ou les données de base de données du module :

bin/magento module:uninstall Magento_SampleMinimal Magento_SampleModifyContent --backup-code --backup-media --backup-db

Messages similaires à l’affichage suivant :

You are about to remove code and/or database tables. Are you sure?[y/N]y
Enabling maintenance mode
Code backup is starting...
Code backup filename: 1435261098_filesystem_code.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Code backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_code.tgz
[SUCCESS]: Code backup completed successfully.
Media backup is starting...
Media backup filename: 1435261098_filesystem_media.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Media backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_media.tgz
[SUCCESS]: Media backup completed successfully.
DB backup is starting...
DB backup filename: 1435261098_db.gz (The archive can be uncompressed with 7-Zip on Windows systems)
DB backup path: /var/www/html/magento2/var/backups/1435261098_db.gz
[SUCCESS]: DB backup completed successfully.
You are about to remove a module(s) that might have database data. Remove the database data manually after uninstalling, if desired.
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module registry in database
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module list in deployment configuration
Removing code from Magento codebase:
Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Removing magento/sample-module-modifycontent (1.0.0)
Removing Magento/SampleModifycontent
  - Removing magento/sample-module-minimal (1.0.0)
Removing Magento/SampleMinimal
Writing lock file
Generating autoload files
Cache cleared successfully.
Generated classes cleared successfully.
Alert: Generated static view files were not cleared. You can clear them using the --clear-static-content option. Failure to clear static view files might cause display issues in the Admin and storefront.
Disabling maintenance mode
NOTE
Des erreurs s’affichent si vous tentez de désinstaller un module avec une dépendance sur un autre module. Dans ce cas, vous ne pouvez pas désinstaller un module ; vous devez désinstaller les deux.

Restauration des fichiers système de fichiers, base de données ou média

Pour restaurer le code base à l’état dans lequel vous l’avez sauvegardé, utilisez la commande suivante :

bin/magento setup:rollback [-c|--code-file="<filename>"] [-m|--media-file="<filename>"] [-d|--db-file="<filename>"]

Où <filename> est le nom du fichier de sauvegarde dans le répertoire <app_root>/var/backups. Pour afficher la liste des fichiers de sauvegarde, saisissez magento info:backups:list

WARNING
Cette commande supprime les fichiers spécifiés ou la base de données avant de les restaurer. Par exemple, l’option --media-file supprime les ressources multimédia sous le répertoire pub/media avant la restauration à partir du fichier de restauration spécifié. Assurez-vous que vous n’avez pas modifié le système de fichiers ou la base de données que vous souhaitez conserver avant d’utiliser cette commande.
NOTE
Pour afficher la liste des fichiers de sauvegarde disponibles, saisissez magento info:backups:list

Cette commande effectue les tâches suivantes :

  1. Met le magasin en mode de maintenance.

  2. Vérifie le nom du fichier de sauvegarde.

  3. Si vous spécifiez un fichier de restauration de code :

    a. Vérifie que les emplacements de destination de restauration sont modifiables (notez que les dossiers pub/static et var sont ignorés).

    b. Supprime tous les fichiers et répertoires sous le répertoire d’installation de votre application.

    c. Extrait le fichier d’archive vers les emplacements de destination.

  4. Si vous spécifiez un fichier de restauration de base de données :

    a. Permet de déposer l'intégralité de la base de données.

    b. Restaure la base de données à l’aide de la sauvegarde de la base de données.

  5. Si vous spécifiez un fichier de restauration multimédia :

    a. Vérifie que les emplacements de destination de restauration sont modifiables.

    b. Supprime tous les fichiers et répertoires sous pub/media

    c. Extrait le fichier d’archive vers les emplacements de destination.

  6. Supprime le magasin hors mode de maintenance.

Par exemple, pour restaurer une sauvegarde de code (système de fichiers), saisissez les commandes suivantes dans l’ordre indiqué :

  • Afficher une liste de sauvegardes :

    code language-bash 
    magento info:backups:list

  • Restaurer une sauvegarde de fichier nommée 1433876616_filesystem.tgz :

    code language-bash 
    magento setup:rollback --code-file="1433876616_filesystem.tgz"

    Messages similaires à l’affichage suivant :

    code language-none 
    Enabling maintenance mode
Code rollback is starting ...
Code rollback filename: 1433876616_filesystem.tgz
Code rollback file path: /var/www/html/magento2/var/backups/1433876616_filesystem.tgz
[SUCCESS]: Code rollback has completed successfully.
Disabling maintenance mode
NOTE
Pour exécuter à nouveau la commande magento sans modifier les répertoires, vous devrez peut-être saisir cd pwd.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995