テーマのアンインストール
このコマンドを使用する前に、テーマへの相対パスを知っておく必要があります。 テーマは <magento_root>/app/design/<area name> のサブディレクトリにあります。 領域で始まるテーマのパスを指定する必要があります。frontend （ストアフロントテーマの場合）または adminhtml （管理テーマの場合）のいずれかです。
例えば、Adobe Commerceで提供される Luma テーマへのパスは frontend/Magento/luma です。
テーマについて詳しくは、「 テーマの構造」を参照してください。
テーマのアンインストールの概要
この節では、1 つ以上のテーマをアンインストールする方法について説明します。テーマのコードはファイルシステムから必要に応じてアンインストールできます。 最初にバックアップを作成して、後でデータを復元できるようにします。
このコマンドは、composer.json で指定された のみ テーマ （Composer パッケージとして提供されているテーマ）をアンインストールします。 テーマが Composer パッケージでない場合は、次の方法で手動でアンインストールする必要があります。
-
テーマへの参照を削除す
theme.xmlように、parentノード情報を更新します。 -
ファイルシステムからテーマコードを削除しています。
テーマのアンインストール
コマンドの使用法：
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は、生成された 静的ビューファイルをクリーンアップします。これは、静的ビューファイルを正しく表示するために必要です。
コマンドは、次のタスクを実行します。
-
指定したテーマのパスが存在することを確認します。存在しない場合は、コマンドは終了します。
-
テーマが Composer パッケージであることを確認します。そうでない場合、コマンドは終了します。
-
依存関係をチェックし、満たされていない依存関係がある場合はコマンドを終了します。
これを回避するには、すべてのテーマを同時にアンインストールするか、テーマに応じてを最初にアンインストールします。
-
テーマが使用されていないことを確認します。使用されている場合は、コマンドが終了します。
-
テーマが仮想テーマのベースでないことを確認します。仮想テーマのベースである場合、コマンドは終了します。
-
ストアをメンテナンスモードにします。
-
--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 からも削除する必要があります。