DocumentaçãoCommerceKB do Commerce

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Arquivo de configuração ausente ou alterado

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

Este artigo fala sobre como resolver o problema em que seus arquivos de configuração foram alterados ou estão ausentes.

Produtos e versões afetados

  • Adobe Commerce na infraestrutura em nuvem, todas as versões

Problema

Os arquivos de configuração config.php e/ou env.php foram alterados incorretamente ou estão ausentes.

Solução

O processo de implantação cria um arquivo de backup para cada arquivo de configuração:

  • app/etc/config.php.bak — contém configurações específicas do sistema e é gerado automaticamente durante a compilação se não existir
  • app/etc/env.php.bak — contém dados confidenciais de configuração

Você pode restaurá-los usando o comando ECE-tools backup:restore.

Os arquivos BAK são um produto do processo de implantação. Se você alterar manualmente um arquivo de configuração após a implantação, suas alterações não serão refletidas nos arquivos BAK existentes.

Para restaurar os arquivos de configuração:

  1. Faça logon no repositório remoto usando o SSH.

  2. Listar os arquivos de backup disponíveis.

    code language-none 
    ./vendor/bin/ece-tools backup:list
    code language-none 
    The list of backup files:
app/etc/env.php
app/etc/config.php

  3. Restaure os arquivos de configuração.

    code language-none 
    ./vendor/bin/ece-tools backup:restore

    Você receberá uma lista dos arquivos de configuração existentes afetados pela restauração.

    code language-none 
    app/etc/env.php file exists! If you want to rewrite existed files use --force
app/etc/config.php file exists! If you want to rewrite existed files use --force

  4. Use a opção --force para substituir todos os arquivos.

    code language-none 
    ./vendor/bin/ece-tools backup:restore --force
    code language-none 
    Command backup:restore with option --force will rewrite your existed files. Do you want to continue [y/N]?y
Backup file app/etc/env.php was restored.
Backup file app/etc/config.php was restored.

  5. Como opção, você pode restaurar um arquivo de configuração específico.

    code language-none 
    ./vendor/bin/ece-tools backup:restore --force --file=app/etc/config.php
    code language-none 
    Command backup:restore with option --force will rewrite your existed files. Do you want to continue [y/N]?y
Backup file app/etc/config.php was restored.
recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a