DocumentatieCommerceInstallatiehandleiding

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Thema's verwijderen

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

Voordat u deze opdracht gebruikt, moet u weten welk relatief pad naar het thema is ingesteld. Thema's bevinden zich in een submap van <magento_root>/app/design/<area name> . U moet het pad naar het thema opgeven dat begint met het gebied: frontend (voor winkelletterthema's) of adminhtml (voor beheerthema's).

Het pad naar het thema Luma dat bij Adobe Commerce wordt geleverd, is bijvoorbeeld frontend/Magento/luma .

Voor meer informatie over thema's, zie ​ themastructuur ​.

Overzicht van het verwijderen van thema's

In deze sectie wordt beschreven hoe u een of meer thema's kunt verwijderen. U kunt desgewenst ook de themacode uit het bestandssysteem opnemen. U kunt eerst back-ups maken, zodat u de gegevens later kunt herstellen.

Dit bevel maakt slechts thema's ongedaan die in composer.json worden gespecificeerd; met andere woorden, thema's die als pakketten Composer worden verstrekt. Als uw thema geen Composer-pakket is, moet u de toepassing handmatig verwijderen door:

Thema's verwijderen

Opdrachtgebruik:

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

Wanneer

  • {theme path} is het relatieve pad naar het thema, te beginnen met de vlaknaam. Het pad naar het lege thema dat bij Adobe Commerce wordt geleverd, is bijvoorbeeld frontend/Magento/blank .
  • --backup-code maakt een back-up van de codebase zoals beschreven in de volgende alinea's.
  • --clear-static-content ontruimt geproduceerde ​ statische meningsdossiers ​, die noodzakelijk is om statische meningsdossiers te veroorzaken om behoorlijk te tonen.

De opdracht voert de volgende taken uit:

  1. Verifieert dat de gespecificeerde themawegen bestaan; als niet, eindigt het bevel.

  2. Verifieert dat het thema een pakket Composer is; als niet, eindigt het bevel.

  3. Controleert op gebiedsdelen en beëindigt het bevel als er om het even welke onvervulde gebiedsdelen zijn.

    Als u dit probleem wilt verhelpen, kunt u alle thema's tegelijkertijd verwijderen of de installatie van de thema's eerst ongedaan maken.

  4. Verifieert dat het thema niet wordt gebruikt; als het wordt gebruikt, eindigt het bevel.

  5. Verifieert dat het thema niet de basis van het virtuele thema is; als het de basis van een virtueel thema is, eindigt het bevel.

  6. Hiermee plaatst u de winkel in de onderhoudsmodus.

  7. Als --backup-code is opgegeven, maakt u een back-up van de codebase, exclusief de mappen pub/static , pub/media en var .

    De naam van het back-upbestand is var/backups/<timestamp>_filesystem.tgz

    U kunt back-ups op elk gewenst moment herstellen met de opdracht magento setup:rollback .

  8. Hiermee verwijdert u thema's uit de databasetabel theme .

  9. Verwijder thema's uit de basis van de code met composer remove .

  10. Wist de cache.

  11. Hiermee worden gegenereerde klassen gewist

  12. Als --clear-static-content wordt gespecificeerd, ontruimt ​ geproduceerde statische meningsdossiers ​.

Als u bijvoorbeeld probeert een thema te verwijderen waarvan een ander thema afhankelijk is, wordt het volgende bericht weergegeven:

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

U kunt beide thema's ook verwijderen terwijl u een back-up van de codebase maakt:

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

Berichten die lijken op de volgende weergave:

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
Als u een beheerthema wilt verwijderen, moet u het ook verwijderen uit de configuratie voor injectie van afhankelijkheden van de component, <component root directory>/etc/di.xml .
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995