Dokumentation Commerce Installationsanleitung

Designs deinstallieren

Letzte Aktualisierung: 18. Dezember 2024

Themen:

Erstellt für:

Experte
Admin
Entwickler

Bevor Sie diesen Befehl verwenden, müssen Sie den relativen Pfad zu Ihrem Design kennen. Designs befinden sich in einem Unterverzeichnis von <magento_root>/app/design/<area name>. Sie müssen den Pfad zum Design angeben, beginnend mit dem Bereich , der entweder frontend (für Storefront-Designs) oder adminhtml (für Admin-Designs) ist.

Beispielsweise lautet der Pfad zum Luma-Design, das mit Adobe Commerce bereitgestellt wird, frontend/Magento/luma.

Weitere Informationen zu Designs finden Sie unter Design-Struktur.

Überblick über die Deinstallation von Designs

In diesem Abschnitt wird beschrieben, wie Sie ein oder mehrere Designs deinstallieren, wobei Sie optional den Code der Designs aus dem Dateisystem einschließen. Sie können zunächst Sicherungskopien erstellen, damit Sie die Daten später wiederherstellen können.

Mit diesem Befehl werden nur Designs deinstalliert, die in composer.json angegeben sind, d. h. Designs, die als Composer-Pakete bereitgestellt werden. Wenn Ihr Design kein Composer -Paket ist, müssen Sie es manuell deinstallieren, indem Sie:

Aktualisieren der parent Knoteninformationen in theme.xml zum Entfernen von Verweisen auf das Design.
Entfernen des Design-Codes aus dem Dateisystem.

Weitere Informationen zur Designvererbung.

Designs deinstallieren

Befehlsverwendung:

bin/magento theme:uninstall [--backup-code] [-c|--clear-static-content] {theme path} ... {theme path}

Hierbei gilt

{theme path} ist der relative Pfad zum Design, beginnend mit dem Bereichsnamen. Beispielsweise lautet der Pfad zum leeren Design, das in Adobe Commerce bereitgestellt wird, frontend/Magento/blank.
--backup-code sichert die Code-Basis, wie in den folgenden Absätzen erläutert.
--clear-static-content bereinigt generierte statische Ansichtsdateien die erforderlich sind, damit statische Ansichtsdateien ordnungsgemäß angezeigt werden.

Der Befehl führt die folgenden Aufgaben aus:

Überprüft, ob die angegebenen Designpfade vorhanden sind. Andernfalls wird der Befehl beendet.
Überprüft, ob es sich bei dem Design um ein Composer-Paket handelt. Andernfalls wird der Befehl beendet.
Sucht nach Abhängigkeiten und beendet den Befehl, wenn nicht erfüllte Abhängigkeiten vorliegen.

Um dies zu umgehen, können Sie entweder alle Designs gleichzeitig deinstallieren oder je nach Design zuerst deinstallieren.
Stellt sicher, dass das Design nicht verwendet wird. Wenn es verwendet wird, wird der Befehl beendet.
Überprüft, ob das Design nicht die Basis des virtuellen Designs ist. Wenn es die Basis eines virtuellen Designs ist, wird der Befehl beendet.
Versetzt den Speicher in den Wartungsmodus.
Wenn --backup-code angegeben ist, sichern Sie die Codebasis, mit Ausnahme der pub/static-, pub/media- und var.

Der Name der Sicherungsdatei lautet var/backups/<timestamp>_filesystem.tgz

Sie können Sicherungskopien jederzeit mit dem Befehl magento setup:rollback wiederherstellen.
Entfernt Designs aus der theme.
Entfernen von Designs aus der Code-Basis mithilfe von composer remove.
Löscht den Cache.
Bereinigt generierte Klassen
Wenn --clear-static-content angegeben ist, bereinigt generierte statische Ansichtsdateien.

Wenn Sie beispielsweise versuchen, ein Design zu deinstallieren, von dem ein anderes Design abhängig ist, wird die folgende Meldung angezeigt:

Cannot uninstall frontend/ExampleCorp/SampleModuleTheme because the following package(s) depend on it:
        ExampleCorp/sample-module-theme-depend

Eine Alternative besteht darin, beide Designs gleichzeitig zu deinstallieren, indem Sie die Code-Basis wie folgt sichern:

bin/magento theme:uninstall frontend/ExampleCorp/SampleModuleTheme frontend/ExampleCorp/SampleModuleThemeDepend --backup-code

Meldungen ähnlich der folgenden werden angezeigt:

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.Removing frontend/ExampleCorp/SampleModuleTheme, frontend/ExampleCorp/SampleModuleThemeDepend from database
Loading composer repositories with package information
Updating dependencies (including require-dev)
Removing frontend/ExampleCorp/SampleModuleTheme, frontend/ExampleCorp/SampleModuleThemeDepend from Magento codebase
  - Removing ExampleCorp/sample-module-theme-depend (dev-master)
Removing ExampleCorp/SampleThemeDepend
  - Removing ExampleCorp/sample-module-theme (dev-master)
Removing ExampleCorp/SampleTheme
Writing lock file
Generating autoload files
Cache 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

Um ein Admin-Design zu deinstallieren, müssen Sie es auch <component root directory>/etc/di.xml aus der Abhängigkeitsinjektionskonfiguration Ihrer Komponente entfernen.

recommendation-more-help