Instalar uma extensão
A Adobe recomenda trabalhar em uma ramificação de desenvolvimento ao adicionar uma extensão à implementação. Ao instalar uma extensão, o nome da extensão (<VendorName>_<ComponentName>
) é inserido automaticamente no arquivo app/etc/config.php
. Não há necessidade de editar o arquivo diretamente.
Para instalar uma extensão:
-
Na estação de trabalho local, altere para o diretório do projeto.
-
Criar ou dar baixa em uma ramificação de desenvolvimento. Consulte ramificação.
-
Usando o nome e a versão do Composer, adicione a extensão à seção
require
do arquivocomposer.json
.composer require <extension-name>:<version> --no-update
-
Atualize as dependências do projeto.
composer update
-
Adicionar, confirmar e enviar alterações de código.
git add -A
git commit -m "Install <extension-name>"
git push origin <branch-name>
WARNING
Ao instalar uma extensão, você deve incluir o arquivocomposer.lock
ao enviar alterações de código para o ambiente remoto. O comandocomposer install
lê o arquivocomposer.lock
para habilitar as dependências definidas no ambiente remoto. -
Após a conclusão da build e implantação, use um SSH para fazer logon no ambiente remoto e verificar a extensão instalada.
bin/magento module:status <extension-name>
Um nome de extensão usa o formato:
<VendorName>_<ComponentName>
.Exemplo de resposta:
Module is enabled
Se você encontrar erros de implantação, consulte falha de implantação de extensão.
Gerenciar extensões
Ao adicionar uma extensão usando o Composer, o processo de implantação ativa automaticamente a extensão. Se você já tiver a extensão instalada, poderá ativar ou desativar a extensão usando a CLI. Ao gerenciar extensões, use o formato: <VendorName>_<ComponentName>
Nunca ative ou desative uma extensão enquanto estiver conectado em ambientes remotos.
Para ativar ou desativar uma extensão:
-
Na estação de trabalho local, altere para o diretório do projeto.
-
Ative ou desative um módulo. O comando
module
atualiza o arquivoconfig.php
com o status solicitado do módulo.Habilite um módulo.
bin/magento module:enable <module-name>
Desative um módulo.
bin/magento module:disable <module-name>
-
Se você habilitou um módulo, use
ece-tools
para atualizar a configuração../vendor/bin/ece-tools module:refresh
-
Verifique o status de um módulo.
bin/magento module:status <module-name>
-
Adicionar, confirmar e enviar alterações de código.
git add -A
git commit -m "Disable <extension-name>"
git push origin <branch-names>