Ativar ou desativar módulos
Esse comando não tem pré-requisitos.
Status do módulo
Use o seguinte comando para listar módulos habilitados e desabilitados:
bin/magento module:status [--enabled] [--disabled] <module-list>
Onde
--enabled
lista todos os módulos habilitados.--disabled
lista todos os módulos desabilitados.<module-list>
é uma lista de módulos delimitada por espaços para verificar o status. Se qualquer nome de módulo contiver caracteres especiais, coloque o nome entre aspas simples ou duplas.
app/etc/config.php
de um ambiente. Consulte Fluxo de trabalho do projeto Pro: Fluxo de trabalho de implantação.Módulo ativar, desativar
Para ativar ou desativar os módulos disponíveis, use o seguinte comando:
bin/magento module:enable [-c|--clear-static-content] [-f|--force] [--all] <module-list>
bin/magento module:disable [-c|--clear-static-content] [-f|--force] [--all] <module-list>
Onde
-
<module-list>
é uma lista de módulos delimitada por espaços para ativar ou desativar. Se qualquer nome de módulo contiver caracteres especiais, coloque o nome entre aspas simples ou duplas. -
--all
para ativar ou desativar todos os módulos ao mesmo tempo. -
-f
ou--force
para forçar um módulo a ser habilitado ou desabilitado apesar das dependências. Antes de usar esta opção, consulte Sobre habilitação e desabilitação de módulos. -
-c
ou--clear-static-content
limpa arquivos de exibição estáticos gerados.A falha na limpeza de arquivos de exibição estáticos pode resultar em problemas se houver vários arquivos com o mesmo nome e você não limpar todos eles.
Em outras palavras, devido às regras de fallback de arquivo estático, se você não limpar os arquivos estáticos e houver mais de um arquivo com o nome
logo.svg
que seja diferente, o fallback poderá fazer com que o arquivo errado seja exibido.
Por exemplo, para desabilitar o módulo Magento_Weee
, digite:
bin/magento module:disable Magento_Weee
Para obter informações importantes sobre habilitação e desabilitação de módulos, consulte Sobre habilitação e desabilitação de módulos.
Atualizar o banco de dados
Se você ativou um ou mais módulos, execute o seguinte comando para atualizar o banco de dados:
bin/magento setup:upgrade
Em seguida, limpe o cache:
bin/magento cache:clean
Sobre a ativação e desativação de módulos
O Adobe Commerce permite ativar ou desativar os módulos disponíveis no momento; em outras palavras, qualquer módulo fornecido por Adobe ou qualquer módulo de terceiros disponível no momento.
Determinados módulos têm dependências em outros módulos, nesse caso, você não pode ativar ou desativar um módulo porque ele tem dependências em outros módulos.
Além disso, pode haver módulos conflitantes que não podem ser habilitados ao mesmo tempo.
Exemplos:
-
O módulo A depende do módulo B. Você não pode desativar o módulo B a menos que primeiro desative o módulo A.
-
O módulo A depende do módulo B, que está desativado. Você deve ativar o módulo B antes de ativar o módulo A.
-
O módulo A está em conflito com o módulo B. Você pode desabilitar os Módulos A e B, ou pode desabilitar ambos os módulos, mas não pode habilitar os Módulos A e B ao mesmo tempo.
-
As dependências são declaradas no campo
require
no arquivocomposer.json
do Adobe Commerce para cada módulo. Conflitos são declarados no campoconflict
nos arquivoscomposer.json
dos módulos. Usamos essas informações para criar um gráfico de dependências:A->B
significa que o módulo A depende do módulo B. -
Uma cadeia de dependência é o caminho de um módulo para outro. Por exemplo, se o módulo A depende do módulo B, e o módulo B depende do módulo C, a cadeia de dependência é
A->B->C
.
Se você tentar ativar ou desativar um módulo que depende de outros módulos, o gráfico de dependência é exibido na mensagem de erro.
composer.json
do módulo A declare um conflito com o módulo B, mas não vice-versa.Somente linha de comando: Para forçar um módulo a ser habilitado ou desabilitado, independentemente de suas dependências, use o argumento --force
opcional.
--force
pode desabilitar seu armazenamento e causar problemas ao acessar o Administrador.