モジュールのアンインストール
この節では、1 つ以上のモジュールをアンインストールする方法について説明します。 アンインストール時に、モジュールのコード、データベーススキーマ、データベースデータをオプションで削除できます。 最初にバックアップを作成して、後でデータを回復できるようにします。
モジュールを使用しないことが確実な場合にのみ、モジュールをアンインストールしてください。 モジュールをアンインストールする代わりに、 モジュールの有効化または無効化で説明されているように無効にすることができます。
NOTEcomposer.json ファイルで宣言されている依存関係のみを確認します。 composer.json ファイルで定義されて ない モジュールをアンインストールする場合、このコマンドは依存関係を確認せずにモジュールをアンインストールします。 ただし、このコマンドはモジュールのコードをファイルシステムから削除 しません。 モジュールのコード（例：rm -rf <path to module>）を削除するには、ファイルシステムツールを使用する必要があります。 別の方法として、Composer 以外のモジュールを 無効することもできます。コマンドの使用法：
bin/magento module:uninstall [--backup-code] [--backup-media] [--backup-db] [-r|--remove-data] [-c|--clear-static-content] \
{ModuleName} ... {ModuleName}
ここで、{ModuleName} は <VendorName>_<ModuleName> 形式のモジュール名を指定します。 例えば、顧客モジュール名は Magento_Customer です。 モジュール名のリストを取得するには、magento module:status と入力します
モジュールのアンインストール コマンドは、次のタスクを実行します。
-
指定したモジュールがコード ベースに存在し、Composer によってインストールされたパッケージであることを確認します。
このコマンドは、Composer パッケージとして定義されたモジュールで のみ 機能します。
-
他のモジュールとの依存関係をチェックし、満たされていない依存関係がある場合はコマンドを終了します。
この問題を回避するには、すべてのモジュールを同時にアンインストールするか、最初に依存モジュールをアンインストールします。
-
続行の確認を要求します。
-
ストアをメンテナンスモードにします。
-
次のコマンド オプションを処理します。
オプション 意味 バックアップ ファイルの名前と場所 --backup-codeファイルシステムをバックアップします（ varディレクトリとpub/staticディレクトリを除く）。var/backups/<timestamp>_filesystem.tgz--backup-mediapub/media ディレクトリをバックアップします。 var/backups/<timestamp>_filesystem_media.tgz--backup-dbデータベースをバックアップします。 var/backups/<timestamp>_db.gz -
--remove-dataが指定されている場合は、モジュールのUninstallクラスで定義されているデータベーススキーマとデータを削除します。指定したモジュールをアンインストールするたびに、は
Uninstallクラスのuninstallメソッドを呼び出します。 このクラスは Magento\Framework\Setup\UninstallInterface から継承する必要があります。 -
指定されたモジュールを
setup_moduleデータベース テーブルから削除します。 -
指定されたモジュールを 展開の構成のモジュール一覧から削除します。
-
composer removeを使用してコードベースからコードを削除します。NOTEモジュールを 常に アンインストールすると、composer remove実行されます。--remove-dataオプションは、モジュールのUninstallクラスによって定義されたデータベースデータおよびスキーマを削除します。 -
キャッシュをクリアします。
-
生成されたクラスを更新します。
-
--clear-static-contentが指定されている場合、は 生成された静的ビューファイルをクリーンアップします。 -
ストアをメンテナンスモードから削除します。
例えば、別のモジュールが依存しているモジュールをアンインストールしようとすると、次のメッセージが表示されます。
magento module:uninstall Magento_SampleMinimal
Cannot uninstall module 'Magento_SampleMinimal' because the following module(s) depend on it:
Magento_SampleModifyContent
モジュール ファイル システム、pub/media ファイル、およびデータベース テーブルをバックアップした後で、モジュールのデータベース スキーマまたはデータを削除して 以 の方法で両方のモジュールをアンインストールすることもできます。
bin/magento module:uninstall Magento_SampleMinimal Magento_SampleModifyContent --backup-code --backup-media --backup-db
次のようなメッセージが表示されます。
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
ファイル・システム、データベース、メディア・ファイルのロール・バック
コードベースをバックアップした状態に復元するには、次のコマンドを使用します。
bin/magento setup:rollback [-c|--code-file="<filename>"] [-m|--media-file="<filename>"] [-d|--db-file="<filename>"]
ここで、<filename> は <app_root>/var/backups ディレクトリ内のバックアップファイルの名前です。 バックアップ ファイルの一覧を表示するには、magento info:backups:list と入力します
WARNING--media-file オプションを指定すると、pub/media ディレクトリの下のメディアアセットが削除されてから、指定したロールバックファイルから復元されます。 このコマンドを使用する前に、保存するファイル・システムまたはデータベースを変更していないことを確認してください。NOTEmagento info:backups:list と入力しますこのコマンドは、次のタスクを実行します。
-
ストアをメンテナンスモードにします。
-
バックアップ ファイル名を確認します。
-
コードのロールバックファイルを指定した場合：
a. ロールバック先の場所が書き込み可能であることを確認します（
pub/staticフォルダーとvarフォルダーは無視されます）。b. アプリケーションのインストールディレクトリの下にあるすべてのファイルとディレクトリを削除します。
c. アーカイブ・ファイルをデスティネーションの場所に抽出します。
-
データベース・ロールバック・ファイルを指定する場合：
a. データベース全体を削除します。
b. データベース バックアップを使用してデータベースをリストアします。
-
メディア ロールバック ファイルを指定した場合：
a. ロールバック先の場所が書き込み可能であることを確認します。
b.
pub/mediaのすべてのファイルとディレクトリを削除しますc. アーカイブ・ファイルをデスティネーションの場所に抽出します。
-
ストアをメンテナンスモードから削除します。
例えば、コード（ファイルシステム）のバックアップを復元するには、次のコマンドを表示された順序で入力します。
-
バックアップの一覧を表示する：
magento info:backups:list -
1433876616_filesystem.tgzという名前のファイル バックアップを復元します。magento setup:rollback --code-file="1433876616_filesystem.tgz"次のようなメッセージが表示されます。
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
NOTEmagento コマンドを再度実行するには、cd pwd を入力する必要があります。