DocumentazioneExperience Cloud KCS

Adobe Commerce: file di configurazione mancante o modificato

Ultimo aggiornamento: 5 agosto 2026

Questo articolo descrive come risolvere i file di configurazione mancanti o modificati.

Descrizione description

Ambiente

  • Adobe Commerce sull’infrastruttura cloud

Problema/Sintomi

I file di configurazione config.php e/o env.php non sono stati modificati correttamente o sono mancanti.

Risoluzione resolution

Il processo di distribuzione crea un file di backup per ciascun file di configurazione:

  • app/etc/config.php.bak - contiene impostazioni specifiche del sistema e viene generato automaticamente durante la compilazione se non esiste
  • app/etc/env.php.bak - contiene dati di configurazione sensibili

È possibile ripristinarli utilizzando il comando ECE-tools backup:restore. I file BAK vengono generati dal processo di distribuzione. Se si modifica manualmente un file di configurazione dopo la distribuzione, le modifiche non verranno applicate ai file BAK esistenti.

Per ripristinare i file di configurazione:

  1. Accedi al tuo archivio remoto utilizzando SSH.

  2. Elencare i file di backup disponibili.

    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. Ripristinare i file di configurazione.

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

    Viene visualizzato un elenco dei file di configurazione esistenti interessati dal ripristino.

    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. Utilizzare l’opzione --force per sovrascrivere tutti i file.

    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. In alternativa, è possibile ripristinare un file di configurazione specifico.

    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