DokumentationExperience Cloud KCS

Adobe Commerce: Fehlende oder geänderte Konfigurationsdatei

Letzte Aktualisierung: 6. August 2026

In diesem Artikel wird beschrieben, wie Sie fehlende oder geänderte Konfigurationsdateien beheben können.

Beschreibung description

Umgebung

  • Adobe Commerce auf Cloud-Infrastruktur

Problem/Symptome

Konfigurationsdateien config.php und/oder env.php wurden falsch geändert oder fehlen.

Lösung resolution

Beim Bereitstellungsprozess wird für jede Konfigurationsdatei eine Sicherungsdatei erstellt:

  • app/etc/config.php.bak - enthält systemspezifische Einstellungen und wird automatisch während des Builds generiert, wenn es noch nicht vorhanden ist.
  • app/etc/env.php.bak - enthält vertrauliche Konfigurationsdaten

Sie können sie mithilfe des Befehls ECE-Tools backup:restore wiederherstellen. Die BAK-Dateien werden vom Bereitstellungsprozess generiert. Wenn Sie eine Konfigurationsdatei nach der Bereitstellung manuell ändern, werden Ihre Änderungen nicht in den vorhandenen BAK-Dateien übernommen.

So stellen Sie die Konfigurationsdateien wieder her:

  1. Melden Sie sich mit „SSH​ bei Ihrem Remote-Repository ​.

  2. Listet die verfügbaren Backup-Dateien auf.

    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. Stellen Sie die Konfigurationsdateien wieder her.

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

    Sie erhalten eine Liste der vorhandenen Konfigurationsdateien, die von der Wiederherstellung betroffen sind.

    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. Verwenden Sie die Option --force , um alle Dateien zu überschreiben.

    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. Optional können Sie eine bestimmte Konfigurationsdatei wiederherstellen.

    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