DocumentaçãoKCS da Experience Cloud

Adobe Commerce: arquivo de configuração ausente ou alterado

Última atualização: 5 de agosto de 2026

Este artigo descreve como resolver arquivos de configuração ausentes ou alterados.

Descrição description

Ambiente

  • Adobe Commerce na infraestrutura em nuvem

Problema/Sintomas

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

Resolução resolution

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 gerados pelo 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
experience-cloud-kcs-help-kbarticles