By name: shopware-phpunit description: Best practices for writing PHPUnit tests in Shopware 6 projects, including integration tests, unit tests, and common testing patterns for plugins and apps. license: MIT metadata: author: FriendsOfShopware version: "1.0.0" organization: FriendsOfShopware date: February 2026 abstract: Comprehensive guide for writing effective PHPUnit tests in Shopware 6, covering integration test setup, repository testing, storefront and API testing, mocking services, and common pitfalls.
Shopware PHPUnit Best Practices
When to Apply
- Writing new PHPUnit tests for a Shopware 6 plugin or app
- Setting up test infrastructure for a Shopware project
- Testing repositories, services, commands, or event subscribers
- Writing integration tests that require the Shopware kernel
- Testing Storefront controllers or Store API / Admin API routes
- Debugging failing tests in a Shopware context
Rule Categories by Priority
| Priority | Category | Prefix | Description |
|---|---|---|---|
| CRITICAL | Test Setup | setup- |
Kernel bootstrap, base test classes, PHPUnit configuration |
| HIGH | Integration Testing | integration- |
Repository tests, service tests, database transactions |
| HIGH | API Testing | api- |
Store API and Admin API endpoint testing |
| MEDIUM | Mocking | mock- |
Service mocking, dependency injection in tests |
| MEDIUM | Data | data- |
Test data creation, fixtures, cleanup |
| LOW | Performance | perf- |
Test execution speed, parallel testing |
How to Use
Read relevant reference files from the references/ directory based on the task at hand. Files are prefixed by category for easy discovery.