[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

解除安裝主題

使用此指令之前,您必須知道佈景主題的相對路徑。 主題位於<magento_root>/app/design/<area name>的子目錄中。 您必須指定以區域開頭的佈景主題路徑,其為frontend (適用於店面佈景主題)或adminhtml (適用於管理佈景主題)。

例如,Adobe Commerce提供的Luma主題路徑是frontend/Magento/luma

如需主題的詳細資訊,請參閱主題結構

解除安裝主題概觀

本節討論如何解除安裝一或多個主題,選擇性地包括檔案系統中的主題程式碼。 您可以先建立備份,以便稍後還原資料。

這個命令只會解除安裝​ 中指定的 ​僅composer.json個主題;換言之,是提供為Composer套件的主題。 如果您的佈景主題不是Composer套件,則必須透過以下方式手動解除安裝:

  • 正在更新parent中的theme.xml節點資訊以移除對主題的參照。

  • 正在從檔案系統移除主題程式碼。

    主題繼承的詳細資訊

解除安裝主題

命令使用方式:

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

位置

  • {theme path}是佈景主題的相對路徑,從區域名稱開始。 例如,Adobe Commerce提供的空白佈景主題的路徑是frontend/Magento/blank
  • --backup-code會備份程式碼基底,如下面的段落所述。
  • --clear-static-content清除產生的靜態檢視檔案,這是讓靜態檢視檔案正確顯示所必需的。

指令會執行下列工作:

  1. 驗證指定的主題路徑是否存在;如果不存在,則終止指令。

  2. 驗證主題是否為撰寫器套件;如果不是,則命令會終止。

  3. 檢查相依性,如果有任何未滿足的相依性,則終止指令。

    若要解決此問題,您可以同時解除安裝所有主題,也可以先根據主題解除安裝。

  4. 驗證主題是否未被使用;如果正在使用它,則命令終止。

  5. 確認主題不是虛擬主題的基底;如果它是虛擬主題的基底,則命令終止。

  6. 將商店置於維護模式。

  7. 若指定--backup-code,請備份程式碼基底,排除pub/staticpub/mediavar目錄。

    備份檔案名稱為var/backups/<timestamp>_filesystem.tgz

    您可以隨時使用magento setup:rollback命令還原備份。

  8. theme資料庫資料表中移除主題。

  9. 使用composer remove從程式碼基底移除主題。

  10. 清除快取。

  11. 清除產生的類別

  12. 若指定--clear-static-content,則清除產生的靜態檢視檔

例如,如果您嘗試解除安裝另一個主題所依賴的主題,會顯示以下訊息:

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

另一種選擇是同時解除安裝兩個主題,如備份程式碼基底:

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

類似下列顯示的訊息:

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
若要解除安裝Admin主題,您也必須從元件的相依性插入設定<component root directory>/etc/di.xml中移除該主題。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995