설명서Experience Cloud KCS

Adobe Commerce: 구성 파일이 없거나 변경되었습니다.

마지막 업데이트: 2026년 8월 5일

이 문서에서는 누락되거나 변경된 구성 파일을 해결하는 방법에 대해 설명합니다.

설명 description

환경

  • 클라우드 인프라의 Adobe Commerce

문제/증상

구성 파일 config.php 및/또는 env.php이(가) 잘못 변경되었거나 없습니다.

해결 방법 resolution

배포 프로세스는 각 구성 파일에 대한 백업 파일을 작성합니다.

  • app/etc/config.php.bak - 시스템별 설정을 포함하며, 없는 경우 빌드하는 동안 자동으로 생성됩니다.
  • app/etc/env.php.bak - 중요한 구성 데이터를 포함합니다.

ECE-tools backup:restore 명령을 사용하여 복원할 수 있습니다. BAK 파일은 배포 프로세스에 의해 생성됩니다. 배포 후 구성 파일을 수동으로 변경하는 경우 변경 사항이 기존 BAK 파일에 반영되지 않습니다.

구성 파일을 복원하려면 다음을 수행하십시오.

  1. SSH을(를) 사용하여 원격 저장소에 로그인합니다.

  2. 사용 가능한 백업 파일을 나열합니다.

    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. 구성 파일을 복원합니다.

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

    복원의 영향을 받는 기존 구성 파일 목록을 받게 됩니다.

    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. --force 옵션을 사용하여 모든 파일을 덮어씁니다.

    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. 선택적으로 특정 구성 파일을 복원할 수 있습니다.

    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