Shopware 6.3.5.2生产模板下如何运行全量单元与E2E测试
生产模板环境下Shopware 6.3.5.2测试落地实现流程
前置适配(解决官方指引psh.phar依赖不兼容问题)
- 生产模板未内置核心开发场景使用的
psh.phar工具,无需安装该工具,可通过Composer、本地开源测试组件完成全流程配置,完全适配生产模板的原生目录结构,不侵入核心文件 - 测试基础依赖安装:在项目根目录执行
composer require --dev phpunit/phpunit:^9.5 symfony/css-selector symfony/browser-kit,所有组件版本与Shopware 6.3.5.2核心内置版本严格对齐,避免版本冲突引发核心功能异常 - 测试目录规范要求:所有自定义插件的测试代码,必须存放于插件自身的
src/Test目录下,禁止写入Shopware核心目录、公共根目录的测试文件夹,避免插件迭代、卸载时污染核心文件
单元测试落地流程
该流程覆盖两大核心测试目标:自定义静态插件二次开发的核心回归验证、新增业务功能的配套测试编写
- 测试配置适配:在项目根目录新建
phpunit.xml配置文件,替换官方核心开发版的默认配置,指定测试扫描范围覆盖两类路径:核心业务逻辑目录vendor/shopware/core/、所有自定义插件的测试目录custom/plugins/*/src/Test/ - 测试用例编写规则:
- 针对插件二次开发修改核心逻辑的场景,编写对应核心依赖类的测试用例,验证修改后的逻辑未偏离核心接口契约,避免破坏核心运行链路
- 针对新增业务功能,在插件的测试目录下新建与业务逻辑类路径匹配的测试类,继承Shopware核心内置的
KernelTestCase基类,直接复用核心提供的容器实例、数据库连接能力,无需重复编写通用初始化逻辑
- 测试执行方式:在项目根目录直接运行
vendor/bin/phpunit --configuration phpunit.xml,无需依赖psh脚本,执行完成后可直接获取两类测试结果:核心功能回归测试通过率、插件自定义业务测试通过率,快速定位插件修改是否引发核心功能损坏 - 迭代校验规则:每次插件提交前,先运行核心目录下的单元测试集,确保核心功能100%通过后,再运行插件自身的测试用例,避免上线后出现无感知的核心逻辑损坏
端到端测试落地流程
- 替换官方psh.phar自动拉起的环境组件:
- 安装与测试环境Chrome版本匹配的本地ChromeDriver组件,替代psh脚本内置的浏览器驱动管理能力
- 在项目根目录的
.env配置文件中新增端到端测试配置项:APP_URL指向测试环境可访问的商城域名,E2E_UPDATE_SCREENSHOTS=0关闭自动截图更新,避免测试环境静态文件路径不匹配引发的执行报错
- 测试用例存放规范:所有端到端测试用例存放于自定义插件的
src/Test/E2E目录下,复用Shopware核心内置的E2EPage基类,直接继承核心提供的页面初始化、登录态复用、元素定位能力,无需重复编写通用测试逻辑 - 测试执行步骤:
- 启动本地ChromeDriver服务:
chromedriver --port=4444 - 执行端到端测试命令:
vendor/bin/phpunit --testsuite E2E --configuration phpunit.xml
- 启动本地ChromeDriver服务:
- 核心回归保障机制:针对自定义插件涉及的前台购物全流程、后台配置操作链路,预先编写3-5个核心节点的基础回归用例,每次插件迭代时优先运行这批基础用例,确认核心流程未被破坏后,再运行新编写的业务功能测试用例
生产环境测试操作避坑规则
- 所有测试类依赖必须放到Composer的
require-dev分组下,不要安装到生产正式依赖列表中,避免线上环境引入不必要的代码体积、安全风险 - 自定义插件的测试用例禁止硬编码生产环境的数据库地址、账号信息,统一通过Shopware核心容器读取环境配置,保证测试代码在开发、测试、生产环境的可迁移性
- 禁止直接修改核心目录下的原有测试用例,所有扩展的测试逻辑必须存放于插件自身目录下,保证插件升级、卸载时不会残留测试代码影响核心功能运行
内容的提问来源于stack exchange,提问作者Alex
相关产品推荐
相关产品推荐

