DocumentaçãoCommerceGuia de instalação

Desinstalar módulos

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

Criado para:

  • undefined
  • undefined
  • undefined

Esta seção discute como desinstalar um ou mais módulos. Durante a desinstalação, você pode remover opcionalmente o código dos módulos, o esquema do banco de dados e os dados do banco de dados. Você pode criar backups primeiro para recuperar os dados mais tarde.

Você só deve desinstalar um módulo se tiver certeza de que não o usará. Em vez de desinstalar um módulo, você pode desabilitá-lo conforme discutido em Habilitar ou desabilitar módulos.

NOTE
Este comando verifica se há apenas dependências declaradas no arquivo composer.json. Se você desinstalar um módulo que seja não definido no arquivo composer.json, esse comando desinstalará o módulo sem verificar as dependências. Este comando não, no entanto, remove o código do módulo do sistema de arquivos. Você deve usar as ferramentas do sistema de arquivos para remover o código do módulo (por exemplo, rm -rf <path to module>). Como alternativa, você pode desabilitar módulos que não sejam do Composer.

Uso do comando:

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

Onde {ModuleName} especifica o nome do módulo no formato <VendorName>_<ModuleName>. Por exemplo, o nome do módulo Cliente é Magento_Customer. Para obter uma lista de nomes de módulo, digite magento module:status

O comando de desinstalação do módulo executa as seguintes tarefas:

  1. Verifica se os módulos especificados existem na base de código e se são pacotes instalados pelo Composer.

    Este comando funciona somente com módulos definidos como pacotes do Composer.

  2. Verifica as dependências com outros módulos e encerra o comando se houver dependências não atendidas.

    Para contornar isso, você pode desinstalar todos os módulos ao mesmo tempo ou desinstalar os módulos dependentes primeiro.

  3. Solicita confirmação para continuar.

  4. Coloca o armazenamento no modo de manutenção.

  5. Processa as seguintes opções de comando.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Opção Significado Nome e local do arquivo de backup
    --backup-code Faz backup do sistema de arquivos (excluindo var e pub/static diretórios). var/backups/<timestamp>_filesystem.tgz
    --backup-media Faz backup do diretório pub/media. var/backups/<timestamp>_filesystem_media.tgz
    --backup-db Faz backup do banco de dados. var/backups/<timestamp>_db.gz

  6. Se --remove-data for especificado, remova o esquema de banco de dados e os dados definidos nas classes Uninstall do módulo.

    Para cada módulo especificado a ser desinstalado, invoca o método uninstall em sua classe Uninstall. Esta classe deve herdar de Magento\Framework\Setup\UninstallInterface.

  7. Remove os módulos especificados da tabela de banco de dados setup_module.

  8. Remove os módulos especificados da lista de módulos na configuração de implantação.

  9. Remove o código da base de código usando composer remove.

    note note
    NOTE
    Desinstalar um módulo sempre executa composer remove. A opção --remove-data remove os dados do banco de dados e o esquema definidos pela classe Uninstall do módulo.

  10. Limpa o cache.

  11. Atualiza classes geradas.

  12. Se --clear-static-content for especificado, limpa arquivos de exibição estáticos gerados.

  13. Retira o armazenamento do modo de manutenção.

Por exemplo, se você tentar desinstalar um módulo do qual outro módulo depende, a seguinte mensagem será exibida:

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

Uma alternativa é desinstalar ambos os módulos após fazer backup do sistema de arquivos do módulo, de pub/media arquivos e das tabelas do banco de dados, mas não removendo o esquema ou os dados do banco de dados do módulo:

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

Mensagens semelhantes a esta são exibidas:

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
Os erros são exibidos se você tentar desinstalar um módulo do com uma dependência de outro módulo. Nesse caso, não é possível desinstalar um módulo; é necessário desinstalar ambos.

Reverter o sistema de arquivos, o banco de dados ou os arquivos de mídia

Para restaurar a base de código para o estado em que você fez o backup, use o seguinte comando:

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

Onde <filename> é o nome do arquivo de backup no diretório <app_root>/var/backups. Para exibir uma lista de arquivos de backup, digite magento info:backups:list

WARNING
Este comando exclui os arquivos especificados ou o banco de dados antes de restaurá-los. Por exemplo, a opção --media-file exclui ativos de mídia no diretório pub/media antes de restaurar a partir do arquivo de reversão especificado. Verifique se você não alterou o sistema de arquivos ou o banco de dados que deseja manter antes de usar este comando.
NOTE
Para exibir uma lista de arquivos de backup disponíveis, digite magento info:backups:list

Esse comando executa as seguintes tarefas:

  1. Coloca o armazenamento no modo de manutenção.

  2. Verifica o nome do arquivo de backup.

  3. Se você especificar um arquivo de reversão de código:

    a. Verifica se os locais de destino de reversão são graváveis (observe que as pastas pub/static e var são ignoradas).

    b. Exclui todos os arquivos e diretórios no diretório de instalação do aplicativo.

    c. Extrai o arquivo de arquivamento para os locais de destino.

  4. Se você especificar um arquivo de rollback de banco de dados:

    a. Descarta todo o banco de dados.

    b. Restaura o banco de dados usando o backup do banco de dados.

  5. Se você especificar um arquivo de reversão de mídia:

    a. Verifica se os locais de destino de rollback são graváveis.

    b. Exclui todos os arquivos e diretórios em pub/media

    c. Extrai o arquivo de arquivamento para os locais de destino.

  6. Retira o armazenamento do modo de manutenção.

Por exemplo, para restaurar um backup de código (ou seja, do sistema de arquivos), insira os seguintes comandos na ordem mostrada:

  • Exibir uma lista de backups:

    code language-bash 
    magento info:backups:list

  • Restaurar um backup de arquivo chamado 1433876616_filesystem.tgz:

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

    Mensagens semelhantes a esta são exibidas:

    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
Para executar o comando magento novamente sem alterar os diretórios, talvez seja necessário inserir cd pwd.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995