ドキュメントCommerce設定ガイド

モジュール出力を無効にする

最終更新日： 2026年5月19日

作成対象：

  • Experienced
  • Admin
  • Developer

デフォルトでは、すべてのモジュールは、モジュール出力がビューに書き込まれるように設定されています。 出力をオフにすると、ハード依存関係によって無効にできないモジュールを実質的に無効にすることができます。

例えば、Customer モジュールはReview モジュールに依存しているため、Review モジュールを無効にすることはできません。 ただし、お客様がレビューを提供しない場合は、Review モジュールの出力をオフにすることができます。

INFO
以前のリリースで管理者を使用してモジュール出力を無効にした場合、これらの設定を移行するようにシステムを手動で設定する必要があります。

出力の無効化は、次のクラスで実行されます。

WARNING
モジュール出力を無効にしても、モジュールは無効になりません。 モジュールは引き続き有効で動作しますが、フロントエンドまたはバックエンドではブロック、ページ、フィールドはレンダリングされません。

パイプラインデプロイメントでのモジュール出力の無効化

パイプラインのデプロイメントまたはその他のデプロイメントで、Commerce アプリケーションの複数のインスタンスを使用してモジュール出力を無効にするには：

  1. Backend モジュールのconfig.xml ファイルを編集します。
  2. 設定の変更を書き出します。

Backend モジュール config.xml ファイルを編集

  1. 元のconfig.xml ファイルをアーカイブします。

  2. <default>要素の直下にある<Magento_install_dir>/vendor/magento/module-backend/etc/config.xml ファイルに、次のような行を追加します。

    code language-xml 
    <advanced>
    <modules_disable_output>
        <Magento_Newsletter>1</Magento_Newsletter>
    </modules_disable_output>
</advanced>

    こちら：

    • <modules_disable_output>にはモジュールのリストが含まれています。
    • <Magento_Newsletter></Magento_Newsletter>は、出力を無効にするモジュールを指定します。
    • 1は、Magento_Newsletter モジュールの出力を無効にするフラグです。

この設定のサンプル結果として、お客様はニュースレターの受信に登録できなくなります。

設定の変更を書き出す

次のコマンドを実行して、設定の変更を書き出します。

bin/magento app:config:dump

結果は<Magento_install_dir>/app/etc/config.php ファイルに書き込まれます。

次に、キャッシュをクリアして、新しい設定を有効にします。

bin/magento cache:clean config

設定のエクスポート ​を参照してください。

シンプルなデプロイメントでモジュール出力を無効にする

Commerceの1つのインスタンスでモジュール出力を無効にする手順は、変更を配布する必要がないため簡単です。

  1. 元の<Magento_install_dir>/app/etc/config.php ファイルをアーカイブします。

  2. advancedとmodules_disable_output セクションをconfig.php ファイルに追加します（存在しない場合）。

    code language-php 
    'system' =>
  array (
    'websites' =>
    array (
      'base' =>
      array (
        'advanced' =>
        array (
          'modules_disable_output' =>
          array (
            'Magento_Review' => '1',
          ),
        ),
      ),
    ),
  ),

この例では、Magento_Review モジュールの出力が無効になっており、お客様は製品をレビューできなくなります。

モジュール出力を再度有効にする

出力を再度有効にするには、モジュールの値を0に設定するか、config.php ファイルから行/モジュールを削除します。

recommendation-more-help
commerce-operations-help-configuration