[僅限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清除產生的靜態檢視檔案,這是讓靜態檢視檔案正確顯示所必需的。
指令會執行下列工作:
-
驗證指定的主題路徑是否存在;如果不存在,則終止指令。
-
驗證主題是否為撰寫器套件;如果不是,則命令會終止。
-
檢查相依性,如果有任何未滿足的相依性,則終止指令。
若要解決此問題,您可以同時解除安裝所有主題,也可以先根據主題解除安裝。
-
驗證主題是否未被使用;如果正在使用它,則命令終止。
-
確認主題不是虛擬主題的基底;如果它是虛擬主題的基底,則命令終止。
-
將商店置於維護模式。
-
若指定
--backup-code,請備份程式碼基底,排除pub/static、pub/media和var目錄。備份檔案名稱為
var/backups/<timestamp>_filesystem.tgz您可以隨時使用
magento setup:rollback命令還原備份。 -
從
theme資料庫資料表中移除主題。 -
使用
composer remove從程式碼基底移除主題。 -
清除快取。
-
清除產生的類別
-
若指定
--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
<component root directory>/etc/di.xml中移除該主題。