Shopware 6插件安装未处理依赖？如何强制校验并自动安装依赖？

核心原因 #

你遇到的问题是因为Shopware的插件系统不会自动读取Composer的包依赖——Composer仅负责确保插件文件存在于文件系统，但插件的激活/安装状态依赖需要单独在Shopware的插件配置中声明，否则系统不会检查依赖插件的激活状态。

解决步骤 #

1. 为插件正确声明Shopware级别的依赖

你需要在每个插件中明确声明其依赖的Shopware插件，有两种方式：

方式一：通过composer.json配置

在每个插件的composer.json的extra字段中添加shopware-plugin-dependencies：

• PluginBbbb的composer.json：

  {
      "extra": {
          "shopware-plugin-dependencies": {
              "PluginAaaa": "*"
          }
      }
  }
  

• PluginCccc的composer.json：

  {
      "extra": {
          "shopware-plugin-dependencies": {
              "PluginBbbb": "*"
          }
      }
  }
  

方式二：通过插件主类注解配置

在插件的主类上使用@Plugin注解的dependencies属性：

• PluginBbbb的主类：

  <?php
  namespace PluginBbbb;
  
  use Shopware\Core\Framework\Plugin;
  use Shopware\Core\Framework\Plugin\Annotation\Plugin;
  
  /**
   * @Plugin(
   *     technicalName="PluginBbbb",
   *     dependencies={"PluginAaaa"}
   * )
   */
  class PluginBbbb extends Plugin
  {
      // 插件逻辑
  }
  

• PluginCccc的主类：

  <?php
  namespace PluginCccc;
  
  use Shopware\Core\Framework\Plugin;
  use Shopware\Core\Framework\Plugin\Annotation\Plugin;
  
  /**
   * @Plugin(
   *     technicalName="PluginCccc",
   *     dependencies={"PluginBbbb"}
   * )
   */
  class PluginCccc extends Plugin
  {
      // 插件逻辑
  }
  

注意：依赖声明中的插件名称必须与对应插件的technicalName完全一致（可通过php bin/console plugin:list查看）。

2. 刷新插件清单并清除缓存

配置完成后，需要让Shopware识别新的依赖配置：

# 刷新插件清单
php bin/console plugin:refresh
# 清除系统缓存
php bin/console cache:clear

3. 依赖检查与自动安装激活

• 阻止未满足依赖的插件安装：现在执行php bin/console plugin:install --activate PluginCccc时，Shopware会自动检查依赖插件的激活状态，如果PluginBbbb/PluginAaaa未安装激活，会直接抛出错误并终止操作。
• 自动安装激活所有依赖：如果希望一键安装激活目标插件及其所有依赖，使用--with-dependencies参数：

  php bin/console plugin:install --activate --with-dependencies PluginCccc
  

内容的提问来源于stack exchange，提问作者Matheus Gontijo