Shopware 6.4.x商店插件第三方Composer包管理方案咨询

为什么你的初始方案被拒绝 #

Shopware商店审核拒绝直接打包第三方包到插件目录（比如你的libs/3rdPartyPackage方式），核心原因是：

• 会引发主项目与插件的依赖版本冲突，破坏Shopware整体依赖管理机制
• 违反Composer依赖管理规范，不符合Shopware插件商店上架准则

分版本适配方案 #

1. 仅兼容Shopware 6.5及以上版本 #

Shopware 6.5新增的executeComposerCommands是官方推荐的依赖管理方式，操作步骤如下：

• 在插件的composer.json中正常声明第三方依赖，与普通Composer项目一致：

{
    "name": "stack/example",
    "require": {
        "vendor/3rd-party-package": "^1.0"
    },
    "autoload": {
        "psr-4": {
            "Stack\\Example\\": "src/"
        }
    }
}

• 在插件主类中重写executeComposerCommands方法并返回true：

<?php

namespace Stack\Example;

use Shopware\Core\Framework\Plugin;

class StackExample extends Plugin
{
    public function executeComposerCommands(): bool
    {
        return true;
    }
}

• 效果：用户安装/更新插件时，Shopware会自动触发Composer命令，将依赖安装到Shopware根目录的vendor文件夹，完全符合审核规范。

2. 需兼容Shopware 6.5以下版本（如6.4） #

由于6.5之前无executeComposerCommands方法，只能通过依赖声明+用户引导处理：

• 在插件的composer.json中明确声明第三方依赖，写法与上述一致
• 关键：绝对不能将第三方包源代码打包进插件，必须让用户通过Composer安装依赖
• 在插件README文档中清晰说明：
  • 若用户通过Composer安装插件，Shopware会自动安装所需依赖
  • 若用户手动上传插件包，需在Shopware根目录执行composer require vendor/3rd-party-package:^1.0

多版本兼容的分支策略 #

若插件需同时支持6.5+和更早版本，建议维护两个独立分支：

• main/v2.x分支：针对Shopware 6.5+，使用executeComposerCommands简化用户操作
• v1.x分支：针对Shopware 6.4及以下，仅声明依赖并完善安装引导文档
• 上架商店时，分别提交对应版本的插件包，标注清晰兼容的Shopware版本范围

内容的提问来源于stack exchange，提问作者Dawid Lewandowski