설명서Commerce설치 안내서

모듈 제거

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 경험
  • 관리자
  • 개발자

이 섹션에서는 하나 이상의 모듈을 제거하는 방법에 대해 설명합니다. 제거하는 동안 선택적으로 모듈의 코드, 데이터베이스 스키마 및 데이터베이스 데이터를 제거할 수 있습니다. 나중에 데이터를 복구할 수 있도록 백업을 먼저 만들 수 있습니다.

모듈을 사용하지 않을 것이 확실한 경우에만 해당 모듈을 제거해야 합니다. 모듈을 제거하는 대신 모듈 활성화 또는 비활성화에서 설명한 대로 모듈을 비활성화할 수 있습니다.

NOTE
이 명령은 composer.json 파일에 선언된 종속성만 확인합니다. composer.json 파일에 정의된 not 모듈을 제거하면 이 명령은 종속성을 확인하지 않고 모듈을 제거합니다. 이 명령은 not ​은(는) 하지만 파일 시스템에서 모듈 코드를 제거합니다. 모듈 코드를 제거하려면 파일 시스템 도구를 사용해야 합니다(예: rm -rf <path to module>). 또는 작성기가 아닌 모듈을 비활성화할 수 있습니다.

명령 사용:

bin/magento module:uninstall [--backup-code] [--backup-media] [--backup-db] [-r|--remove-data] [-c|--clear-static-content] \
  {ModuleName} ... {ModuleName}

여기서 {ModuleName}은(는) 모듈 이름을 <VendorName>_<ModuleName> 형식으로 지정합니다. 예를 들어 고객 모듈 이름은 Magento_Customer입니다. 모듈 이름 목록을 가져오려면 magento module:status을(를) 입력하십시오.

모듈 제거 명령은 다음 작업을 수행합니다.

  1. 지정된 모듈이 코드 베이스에 있고 Composer에서 설치한 패키지인지 확인합니다.

    이 명령은 Composer 패키지로 정의된 모듈에서 only ​을(를) 사용합니다.

  2. 다른 모듈과의 종속성을 확인하고 충족되지 않는 종속성이 있으면 명령을 종료합니다.

    이 문제를 해결하려면 모든 모듈을 동시에 제거하거나 종속 모듈을 먼저 제거할 수 있습니다.

  3. 계속하려면 확인을 요청하십시오.

  4. 저장소를 유지 관리 모드로 전환합니다.

  5. 다음 명령 옵션을 처리합니다.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    옵션 의미 백업 파일 이름 및 위치
    --backup-code 파일 시스템을 백업합니다(var 및 pub/static 디렉터리 제외). var/backups/<timestamp>_filesystem.tgz
    --backup-media pub/media 디렉터리를 백업합니다. var/backups/<timestamp>_filesystem_media.tgz
    --backup-db 데이터베이스 백업. var/backups/<timestamp>_db.gz

  6. --remove-data이(가) 지정된 경우 모듈의 Uninstall 클래스에 정의된 데이터베이스 스키마와 데이터를 제거하십시오.

    제거할 각 모듈에 대해 Uninstall 클래스에서 uninstall 메서드를 호출합니다. 이 클래스는 Magento\Framework\Setup\UninstallInterface에서 상속해야 합니다.

  7. setup_module 데이터베이스 테이블에서 지정된 모듈을 제거합니다.

  8. 배포 구성의 모듈 목록에서 지정된 모듈을 제거합니다.

  9. composer remove을(를) 사용하여 코드베이스에서 코드를 제거합니다.

    note note
    NOTE
    always 모듈을 제거하면 composer remove이(가) 실행됩니다. --remove-data 옵션은 모듈의 Uninstall 클래스로 정의된 데이터베이스 데이터와 스키마를 제거합니다.

  10. 캐시를 지웁니다.

  11. 생성된 클래스를 업데이트합니다.

  12. --clear-static-content이(가) 지정된 경우 생성된 정적 보기 파일을 정리합니다.

  13. 유지 관리 모드에서 스토어를 제거합니다.

예를 들어 다른 모듈이 종속된 모듈을 제거하려고 하면 다음 메시지가 표시됩니다.

magento module:uninstall Magento_SampleMinimal
    Cannot uninstall module 'Magento_SampleMinimal' because the following module(s) depend on it:
        Magento_SampleModifyContent

모듈 파일 시스템, pub/media개의 파일 및 데이터베이스 테이블을 백업한 후 두 모듈을 모두 제거하되 모듈의 데이터베이스 스키마나 데이터를 제거하지 않음 ​하는 방법이 있습니다.

bin/magento module:uninstall Magento_SampleMinimal Magento_SampleModifyContent --backup-code --backup-media --backup-db

다음 디스플레이와 유사한 메시지:

You are about to remove code and/or database tables. Are you sure?[y/N]y
Enabling maintenance mode
Code backup is starting...
Code backup filename: 1435261098_filesystem_code.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Code backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_code.tgz
[SUCCESS]: Code backup completed successfully.
Media backup is starting...
Media backup filename: 1435261098_filesystem_media.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Media backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_media.tgz
[SUCCESS]: Media backup completed successfully.
DB backup is starting...
DB backup filename: 1435261098_db.gz (The archive can be uncompressed with 7-Zip on Windows systems)
DB backup path: /var/www/html/magento2/var/backups/1435261098_db.gz
[SUCCESS]: DB backup completed successfully.
You are about to remove a module(s) that might have database data. Remove the database data manually after uninstalling, if desired.
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module registry in database
Removing Magento_SampleMinimal, Magento_SampleModifyContent from module list in deployment configuration
Removing code from Magento codebase:
Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Removing magento/sample-module-modifycontent (1.0.0)
Removing Magento/SampleModifycontent
  - Removing magento/sample-module-minimal (1.0.0)
Removing Magento/SampleMinimal
Writing lock file
Generating autoload files
Cache cleared successfully.
Generated classes cleared successfully.
Alert: Generated static view files were not cleared. You can clear them using the --clear-static-content option. Failure to clear static view files might cause display issues in the Admin and storefront.
Disabling maintenance mode
NOTE
다른 모듈에 종속된 모듈을 제거하려고 하면 오류가 표시됩니다. 이 경우 모듈 하나를 제거할 수 없으며 두 모듈을 모두 제거해야 합니다.

파일 시스템, 데이터베이스 또는 미디어 파일 롤백

코드베이스를 백업한 상태로 복원하려면 다음 명령을 사용합니다.

bin/magento setup:rollback [-c|--code-file="<filename>"] [-m|--media-file="<filename>"] [-d|--db-file="<filename>"]

여기서 <filename>은(는) <app_root>/var/backups 디렉터리에 있는 백업 파일의 이름입니다. 백업 파일 목록을 표시하려면 magento info:backups:list을(를) 입력하십시오.

WARNING
이 명령은 지정된 파일 또는 데이터베이스를 복원하기 전에 삭제합니다. 예를 들어 --media-file 옵션은 지정된 롤백 파일에서 복원하기 전에 pub/media 디렉터리 아래의 미디어 자산을 삭제합니다. 이 명령을 사용하기 전에 유지할 파일 시스템이나 데이터베이스를 변경하지 않았는지 확인하십시오.
NOTE
사용 가능한 백업 파일 목록을 표시하려면 magento info:backups:list을(를) 입력하십시오.

이 명령은 다음 작업을 수행합니다.

  1. 저장소를 유지 관리 모드로 전환합니다.

  2. 백업 파일 이름을 확인합니다.

  3. 코드 롤백 파일을 지정하는 경우:

    a. 롤백 대상 위치가 쓰기 가능한지 확인합니다(pub/static 및 var 폴더는 무시됨).

    b. 응용 프로그램 설치 디렉터리 아래의 모든 파일과 디렉터리를 삭제합니다.

    c. 아카이브 파일을 대상 위치로 추출합니다.

  4. 데이터베이스 롤백 파일을 지정하는 경우:

    a. 전체 데이터베이스를 삭제합니다.

    b. 데이터베이스 백업을 사용하여 데이터베이스를 복원합니다.

  5. 미디어 롤백 파일을 지정하는 경우:

    a. 롤백 대상 위치가 쓰기 가능한지 확인합니다.

    b. pub/media에서 모든 파일과 디렉터리를 삭제합니다.

    c. 아카이브 파일을 대상 위치로 추출합니다.

  6. 유지 관리 모드에서 스토어를 제거합니다.

예를 들어 코드(파일 시스템) 백업을 복원하려면 다음 명령을 표시된 순서대로 입력합니다.

  • 백업 목록 표시:

    code language-bash 
    magento info:backups:list

  • 이름이 1433876616_filesystem.tgz인 파일 백업 복원:

    code language-bash 
    magento setup:rollback --code-file="1433876616_filesystem.tgz"

    다음 디스플레이와 유사한 메시지:

    code language-none 
    Enabling maintenance mode
Code rollback is starting ...
Code rollback filename: 1433876616_filesystem.tgz
Code rollback file path: /var/www/html/magento2/var/backups/1433876616_filesystem.tgz
[SUCCESS]: Code rollback has completed successfully.
Disabling maintenance mode
NOTE
디렉터리를 변경하지 않고 magento 명령을 다시 실행하려면 cd pwd을(를) 입력해야 할 수 있습니다.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995