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:

  1. Na estação de trabalho local, altere para o diretório do projeto.

  2. Criar ou dar baixa em uma ramificação de desenvolvimento. Consulte ramificação.

  3. Usando o nome e a versão do Composer, adicione a extensão à seção require do arquivo composer.json.

    composer require <extension-name>:<version> --no-update
    
  4. Atualize as dependências do projeto.

    composer update
    
  5. 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 arquivo composer.lock ao enviar alterações de código para o ambiente remoto. O comando composer install lê o arquivo composer.lock para habilitar as dependências definidas no ambiente remoto.
  6. 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:

  1. Na estação de trabalho local, altere para o diretório do projeto.

  2. Ative ou desative um módulo. O comando module atualiza o arquivo config.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>
    
  3. Se você habilitou um módulo, use ece-tools para atualizar a configuração.

    ./vendor/bin/ece-tools module:refresh
    
  4. Verifique o status de um módulo.

    bin/magento module:status <module-name>
    
  5. Adicionar, confirmar e enviar alterações de código.

    git add -A
    
    git commit -m "Disable <extension-name>"
    
    git push origin <branch-names>