DocumentationExperience Cloud KCS

Adobe Commerce : fichier de configuration manquant ou modifié

Dernière mise à jour : 6 août 2026

Cet article décrit comment résoudre des fichiers de configuration manquants ou modifiés.

Description description

Environnement

  • Adobe Commerce sur les infrastructures cloud

Problème/Symptômes

Les fichiers de configuration config.php et/ou env.php ont été modifiés de manière incorrecte ou sont manquants.

Résolution resolution

Le processus de déploiement crée un fichier de sauvegarde pour chaque fichier de configuration :

  • app/etc/config.php.bak : contient des paramètres spécifiques au système et est généré automatiquement lors de la génération s’il n’existe pas
  • app/etc/env.php.bak : contient des données de configuration sensibles.

Vous pouvez les restaurer à l’aide de la commande ECE-tools backup:restore. Les fichiers BAK sont générés par le processus de déploiement. Si vous modifiez manuellement un fichier de configuration après le déploiement, vos modifications ne sont pas répercutées dans les fichiers BAK existants.

Pour restaurer les fichiers de configuration :

  1. Connectez-vous au référentiel distant à l’aide de SSH.

  2. Répertoriez les fichiers de sauvegarde 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. Restaurez les fichiers de configuration.

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

    Vous recevez une liste des fichiers de configuration existants concernés par la restauration.

    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. Utilisez l’option --force pour remplacer tous les fichiers.

    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. Vous pouvez éventuellement restaurer un fichier de configuration spécifique.

    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