[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト(Adobeが管理する PaaS インフラストラクチャ)およびオンプレミスプロジェクトにのみ適用されます。"}

モジュールを有効または無効にする

このコマンドには前提条件はありません。

モジュールステータス

次のコマンドを使用して、有効モジュールと無効モジュールを一覧表示します。

bin/magento module:status [--enabled] [--disabled] <module-list>

どこで

  • --enabledには、有効なすべてのモジュールが一覧表示されます。
  • --disabledには、無効なすべてのモジュールが一覧表示されます。
  • <module-list>は、ステータスを確認するためのモジュールのスペース区切りリストです。 モジュール名に特殊文字が含まれる場合は、名前を一重引用符または二重引用符で囲みます。
NOTE
クラウドプロジェクトでモジュールを直接有効または無効にすることはできません。 これらのコマンドをローカルで実行してから、環境のapp/etc/config.php ファイルに変更をプッシュする必要があります。 Pro プロジェクトワークフロー:デプロイメントワークフローを参照してください。

モジュールの有効化、無効化

使用可能なモジュールを有効または無効にするには、次のコマンドを使用します。

bin/magento module:enable [-c|--clear-static-content] [-f|--force] [--all] <module-list>
bin/magento module:disable [-c|--clear-static-content] [-f|--force] [--all] <module-list>

どこで

  • <module-list>は、有効または無効にするモジュールのスペース区切りリストです。 モジュール名に特殊文字が含まれる場合は、名前を一重引用符または二重引用符で囲みます。

  • --allを使用すると、すべてのモジュールを同時に有効または無効にできます。

  • -fまたは--forceは、依存関係にもかかわらず、モジュールを強制的に有効または無効にします。 このオプションを使用する前に、​ モジュールの有効化と無効化についてを参照してください。

  • -cまたは--clear-static-contentは、生成された静的ビューファイル ​をクリーンアップします。

    静的ビューファイルをクリアしないと、同じ名前のファイルが複数あり、すべてのファイルをクリアできない場合に問題が発生する可能性があります。

    つまり、静的ファイルのフォールバック ​ ルールにより、静的ファイルをクリアせず、logo.svgという名前の異なるファイルが複数ある場合、フォールバックによって間違ったファイルが表示される可能性があります。

例えば、Magento_Weee モジュールを無効にするには、次のように入力します。

bin/magento module:disable Magento_Weee

モジュールの有効化と無効化に関する重要な情報については、​ モジュールの有効化と無効化についてを参照してください

データベースの更新

1つ以上のモジュールを有効にした場合は、次のコマンドを実行してデータベースを更新します。

bin/magento setup:upgrade

次に、キャッシュをクリーニングします。

bin/magento cache:clean

モジュールの有効化と無効化について

Adobe Commerceを使用すると、現在使用可能なモジュールを有効または無効にできます。つまり、Adobeが提供するモジュールや、現在使用可能なサードパーティ製モジュールを有効または無効にできます。

特定のモジュールには他のモジュールへの依存関係があり、その場合、モジュールは他のモジュールへの依存関係があるため、有効または無効にできない場合があります。

さらに、同時に有効にできない​ 競合する ​個のモジュールが存在する場合があります。

例:

  • モジュール Aはモジュール Bに依存する。最初にモジュール Aを無効にしない限り、モジュール Bを無効にすることはできません。

  • モジュール Aはモジュール Bに依存し、どちらも無効です。 モジュール Aを有効にするには、モジュール Bを有効にする必要があります。

  • モジュール Aとモジュール Bが競合しています。モジュール Aとモジュール Bを無効にするか、どちらのモジュールも無効にできますが、モジュール Aとモジュール Bを同時に有効にすることはできません

  • 各モジュールのAdobe Commerce composer.json ファイルのrequire フィールドで依存関係が宣言されます。 モジュールのcomposer.json ファイルのconflict フィールドで競合が宣言されています。 この情報を使用して依存関係グラフを作成します。A->Bは、モジュール Aがモジュール Bに依存することを意味します。

  • 依存関係チェーン​は、モジュールから別の依存関係チェーンへのパスです。 例えば、モジュール Aがモジュール Bに依存し、モジュール Bがモジュール Cに依存する場合、依存関係チェーンはA->B->Cになります。

他のモジュールに依存するモジュールを有効または無効にしようとすると、依存関係グラフがエラーメッセージに表示されます。

NOTE
モジュール Aのcomposer.jsonは、モジュール Bとの競合を宣言しますが、逆にはできません。

コマンドラインのみ: モジュールの依存関係に関係なく、モジュールを強制的に有効または無効にするには、オプションの--force引数を使用します。

NOTE
--forceを使用すると、ストアを無効にし、管理者へのアクセスに問題が発生する可能性があります。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995