DocumentaciónKCS de Experience Cloud

Adobe Commerce: falta el archivo de configuración o se ha modificado

Última actualización: 5 de agosto de 2026

Este artículo describe cómo resolver los archivos de configuración que faltan o que se han alterado.

Descripción description

Entorno

  • Adobe Commerce en la infraestructura en la nube

Problema/Síntomas

Los archivos de configuración config.php y/o env.php se cambiaron incorrectamente o faltan.

Resolución resolution

El proceso de implementación crea un archivo de copia de seguridad para cada archivo de configuración:

  • app/etc/config.php.bak - contiene la configuración específica del sistema y se genera automáticamente durante la compilación si no existe
  • app/etc/env.php.bak - contiene datos de configuración confidenciales

Puede restaurarlos con el comando ECE-tools backup:restore. Los archivos BACK se generan mediante el proceso de implementación. Si cambia manualmente un archivo de configuración después de la implementación, los cambios no se reflejarán en los archivos BACK existentes.

Para restaurar los archivos de configuración:

  1. Inicie sesión en el repositorio remoto usando SSH.

  2. Enumerar los archivos de copia de seguridad disponibles.

    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 los archivos de configuración.

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

    Recibirá una lista de los archivos de configuración existentes afectados por la restauración.

    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. Utilice la opción --force para sobrescribir todos los archivos.

    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. Opcionalmente, puede restaurar un archivo de configuración 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