Arquivos de configuração para implantação

O Adobe Commerce fornece arquivos de configuração que permitem personalizar facilmente um componente e criar tipos de configuração para estender a funcionalidade padrão. O processo de configuração de implantação consiste na configuração compartilhada e específica do sistema para sua instalação. A configuração de implantação do Commerce está dividida entre app/etc/config.php e app/etc/env.php.

  • app/etc/config.php é o arquivo de configuração compartilhado.
    Esse arquivo contém a lista de módulos, temas e pacotes de idioma instalados e as configurações compartilhadas.

    Inclua esse arquivo no controle de origem e use-o em seus sistemas de desenvolvimento, preparo e produção.

  • app/etc/env.php contém configurações específicas para o ambiente de instalação.

Juntos, config.php e env.php são chamados de configuração de implantação do Commerce porque os arquivos são criados durante a instalação e são necessários para iniciar o aplicativo Commerce.

INFO
A configuração de implantação Commerce 2 substitui local.xml em Magento 1.x.

Ao contrário de outros arquivos de configuração de módulo, a configuração de implantação do Commerce é carregada na memória quando, durante a inicialização, não é mesclada com nenhum outro arquivo e não pode ser estendida. (config.php e env.php são mesclados, entretanto.)

Detalhes sobre a configuração de implantação

config.php e env.php são arquivos PHP que retornam uma matriz associativa multidimensional, que é basicamente uma disposição hierárquica de parâmetros e valores de configuração.

No nível superior desta matriz estão segmentos de configuração. Um segmento tem conteúdo arbitrário (um valor escalar ou uma matriz aninhada) diferenciado por uma chave arbitrária, em que o par de chaves e valores é definido pela estrutura do Commerce.

Magento\Framework\App\DeploymentConfig fornece apenas acesso a essas seções, mas não permite que você as estenda.

No próximo nível de hierarquia, os itens em cada segmento são ordenados de acordo com a definição de sequência do módulo, que é obtida ao mesclar todos os arquivos de configuração dos módulos, exceto os módulos desativados.

As seções a seguir discutem a estrutura e o conteúdo da configuração de implantação:

  • Gerenciar módulos instalados
  • Configuração específica do sistema

Gerenciar módulos instalados

O arquivo config.php contém uma lista de módulos instalados. O Adobe Commerce fornece utilitários de linha de comando e baseados na Web para gerenciar módulos (instalar, desinstalar, habilitar, desabilitar ou atualizar).

Exemplos:

config.php

return array (
  'modules' =>
  array (
    'Magento_Core' => 1,
    'Magento_Store' => 1,
    'Magento_Theme' => 1,
    'Magento_Authorization' => 1,
    'Magento_Directory' => 1,
    'Magento_Backend' => 1,
    'Magento_Backup' => 1,
    'Magento_Eav' => 1,
    'Magento_Customer' => 1,
...
  ),
);

O valor 1 ou 0 indica se um módulo está habilitado ou desabilitado.

Os módulos desativados não são reconhecidos pelo aplicativo do Commerce; em outras palavras, eles não participam da configuração de mesclagem, da injeção de dependência, de eventos, plug-ins e assim por diante. Os módulos desativados não modificam a vitrine nem o Administrador e não afetam o roteamento.

A única diferença prática entre um módulo desativado e um módulo ausente na base de código é que um módulo desativado é encontrado pelo carregador automático, e suas classes e constantes estão disponíveis para reutilização em outro código.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c