DokumentationHandelInstallationshandbok

Avinstallera moduler

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

Skapat för:

  • Erfaren
  • Administratör
  • Utvecklare

I det här avsnittet beskrivs hur du avinstallerar en eller flera moduler. Under avinstallationen kan du ta bort modulens kod, databasschema och databasdata. Du kan skapa säkerhetskopior först så att du kan återställa data senare.

Du bör endast avinstallera en modul om du är säker på att du inte kommer att använda den. I stället för att avinstallera en modul kan du inaktivera den enligt beskrivningen i Aktivera eller inaktivera moduler.

NOTE
Det här kommandot kontrollerar att endast beroenden som har deklarerats i filen composer.json har deklarerats. Om du avinstallerar en modul som inte har definierats i filen composer.json avinstalleras modulen med det här kommandot utan att någon kontroll av beroenden görs. Det här kommandot tar inte bort modulens kod från filsystemet. Du måste använda filsystemverktyg för att ta bort modulens kod (till exempel rm -rf <path to module>). Som ett alternativ kan du inaktivera moduler som inte är Composer.

Kommandoanvändning:

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

Där {ModuleName} anger modulnamnet i formatet <VendorName>_<ModuleName>. Kundmodulens namn är till exempel Magento_Customer. Om du vill visa en lista med modulnamn anger du magento module:status

Avinstallationskommandot för modulen utför följande åtgärder:

  1. Verifierar att de angivna modulerna finns i kodbasen och är paket som har installerats av Composer.

    Det här kommandot fungerar endast med moduler definierade som Composer-paket.

  2. Kontrollerar om det finns beroenden till andra moduler och avslutar kommandot om det finns några beroenden som inte uppfylls.

    Du kan undvika detta genom att antingen avinstallera alla moduler samtidigt eller avinstallera de beroende modulerna först.

  3. Begär bekräftelse att fortsätta.

  4. Placerar butiken i underhållsläge.

  5. Bearbetar följande kommandoalternativ.

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Alternativ Betydelse Säkerhetskopians filnamn och plats
    --backup-code Säkerhetskopierar filsystemet (exklusive var- och pub/static-kataloger). var/backups/<timestamp>_filesystem.tgz
    --backup-media Säkerhetskopierar katalogen pub/media. var/backups/<timestamp>_filesystem_media.tgz
    --backup-db Säkerhetskopierar databasen. var/backups/<timestamp>_db.gz

  6. Om --remove-data anges tar du bort databasschemat och data som definierats i modulens Uninstall -klasser.

    Anropar metoden uninstall i klassen Uninstall för varje angiven modul som ska avinstalleras. Den här klassen måste ärva från Magento\Framework\Setup\UninstallInterface.

  7. Tar bort angivna moduler från databastabellen setup_module.

  8. Tar bort angivna moduler från modullistan i distributionskonfigurationen.

  9. Tar bort kod från kodbasen med composer remove.

    note note
    NOTE
    Om du avinstallerar modulen always körs composer remove. Alternativet --remove-data tar bort databasdata och schema som definieras av modulens Uninstall-klass.

  10. Rensar cachen.

  11. Uppdateringsgenererade klasser.

  12. Om --clear-static-content anges rensas genererade statiska vyfiler.

  13. Tar arkivet ur underhållsläge.

Om du till exempel försöker avinstallera en modul som en annan modul är beroende av visas följande meddelande:

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

Ett alternativ är att avinstallera båda modulerna efter säkerhetskopiering av modulens filsystem, pub/media filer och databastabeller, men inte tar bort modulens databasschema eller data:

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

Meddelanden som liknar följande:

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
Fel visas om du försöker avinstallera en modul som är beroende av en annan modul. I så fall kan du inte avinstallera en modul. Du måste avinstallera båda.

Återställ filsystemet, databasen eller mediefilerna

Använd följande kommando om du vill återställa kodbasen till det läge där du säkerhetskopierade den:

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

Där <filename> är namnet på säkerhetskopieringsfilen i katalogen <app_root>/var/backups. Om du vill visa en lista över säkerhetskopierade filer anger du magento info:backups:list

WARNING
Med det här kommandot tas de angivna filerna eller databasen bort innan de återställs. Alternativet --media-file tar till exempel bort medieresurser under katalogen pub/media innan den angivna återställningsfilen återställs. Kontrollera att du inte har ändrat det filsystem eller den databas som du vill behålla innan du använder det här kommandot.
NOTE
Om du vill visa en lista över tillgängliga säkerhetskopieringsfiler anger du magento info:backups:list

Det här kommandot utför följande uppgifter:

  1. Placerar butiken i underhållsläge.

  2. Verifierar namnet på säkerhetskopieringsfilen.

  3. Om du anger en fil för kodinspelning:

    a. Verifierar att målplatserna för återställningen är skrivbara (observera att mapparna pub/static och var ignoreras).

    b. Tar bort alla filer och kataloger under programinstallationskatalogen.

    c. Extraherar arkivfilen till målplatserna.

  4. Om du anger en databasåterställningsfil:

    a. Släpper hela databasen.

    b. Återställer databasen med hjälp av säkerhetskopian av databasen.

  5. Om du anger en medieåterställningsfil:

    a. Verifierar att målplatserna för återställningen är skrivbara.

    b. Tar bort alla filer och kataloger under pub/media

    c. Extraherar arkivfilen till målplatserna.

  6. Tar arkivet ur underhållsläge.

Om du till exempel vill återställa en säkerhetskopia av kod (det vill säga ett filsystem) anger du följande kommandon i den ordning som visas:

  • Visa en lista över säkerhetskopior:

    code language-bash 
    magento info:backups:list

  • Återställ en säkerhetskopia av filen med namnet 1433876616_filesystem.tgz:

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

    Meddelanden som liknar följande:

    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
Om du vill köra kommandot magento igen utan att ändra kataloger kan du behöva ange cd pwd.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995