phpunit-migration-test-generation

PHPUnit Migration Test Generation

Generate Shopware-compliant PHPUnit migration tests that pass PHPStan and PHPUnit validation.

File Write Restrictions

Write ONLY to:

• tests/migration/** — Migration test files

NEVER write to:

• src/** — Source code (read-only)
• tests/unit/** — Unit tests (out of scope)
• tests/integration/** — Integration tests (out of scope)
• Any other directory

Quick Start

1. Read the target migration source class
2. Analyze SQL operations to determine test pattern
3. Apply the migration test template with conditional sections
4. Validate with PHPStan and PHPUnit
5. Fix any errors and repeat
6. Generate completion report

---

Phase 1: Validate Input

1. Verify single file provided
2. Verify file exists and is a PHP class (not interface/trait)
3. Verify path contains Migration/V6_
4. Verify class extends Shopware\Core\Framework\Migration\MigrationStep

If validation fails, return FAILED with reason.

Phase 2: Analyze Source

Read the migration class and extract information needed for test generation. See references/source-analysis.md for detection patterns.

Step 1: Extract Metadata

• Class name, full namespace
• Timestamp from getCreationTimestamp() return value
• #[Package('...')] attribute value — the test class carries the same value. When the migration class carries none, take the value from the nearest src/ directory the test path mirrors, walking up until one exists and using the value its .php files carry. When that yields no value, emit no #[Package] and report that in the Phase 5 report's Package field (none, per references/output-format.md) rather than guessing a value.
• Area from namespace (Core, Administration, Storefront, Elasticsearch)
• Version from namespace (V6_6, V6_7, V6_8)

Step 2: Classify SQL Operations

Read update() and updateDestructive() method bodies. Classify:

• Schema-add: CREATE TABLE, addColumn(), ALTER TABLE ... ADD
• Schema-remove: DROP TABLE, DROP COLUMN, dropColumnIfExists(), dropTableIfExists()
• Data-update: UPDATE, INSERT, DELETE on non-config tables
• Config: system_config operations
• Mail-template: mail_template operations