啟用或停用模組

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

這個命令沒有先決條件。

模組狀態

使用下列命令列出已啟用和已停用的模組：

bin/magento module:status [--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

如需有關啟用和停用模組的重要資訊，請參閱關於啟用和停用模組。

如果您啟用一或多個模組，請執行以下命令來更新資料庫：

bin/magento setup:upgrade

然後清除快取：

bin/magento cache:clean

Adobe Commerce可讓您啟用或停用目前可用的模組；換言之，任何Adobe提供的模組或任何目前可用的協力廠商模組。

某些模組具有對其他模組的相依性，在這種情況下，您可能無法啟用或停用模組，因為它具有對其他模組的相依性。

此外，可能有 個衝突的 模組無法同時啟用。

範例：

模組A相依於模組B。除非先停用模組A，否則無法停用模組B。
模組A相依於模組B，兩者皆已停用。您必須先啟用模組B，才能啟用模組A。
模組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