xml-config-migrating

Migrate Shopware Extension XML Configuration to PHP

Shopware 6.7 deprecates loading Symfony configuration from XML for bundles and plugins; Shopware 6.8 removes it, because Symfony 8 drops the XML loaders entirely. Extensions that still ship XML config break with 6.8.

The migration is mechanical and behavior-neutral: the compiled container and route collection stay identical apart from what verify-dumps.sh classifies as inert. A tool-computed verdict is the only verdict that enters the report.

Scope

In scope	Out of scope (Shopware-specific XML formats — keep as XML)
src/Resources/config/services.xml, services_test.xml	Resources/config/config.xml (plugin settings)
src/Resources/config/routes.xml, routes_<env>.xml, routes_overwrite.xml, any XML under Resources/config/routes/	Resources/config/custom-fields.xml, flow.xml, rule-conditions.xml
src/Resources/config/packages/**/*.xml	App manifest.xml

packages/** config is loaded only by a bundle that calls buildDefaultConfig(), which in Shopware is its own core bundles and nothing else; a plugin's packages files are inert unless the extension loads them itself. They stay in scope regardless — dead XML is still XML that has to be gone before 6.8 — but nothing in this workflow can observe their content, so Step 7 and Step 10 treat a packages row differently from every other row.

Prerequisites

• A working Shopware installation (6.6+) with the extension installed and active, and bin/console working. Run every console command through the project's development environment.
• jq available on the host for verify-dumps.sh.
• The dump directory and the extension sources readable from where the bundled scripts run.

${CLAUDE_SKILL_DIR} is this skill's own directory; on a host that does not define it, substitute the path to this skill's directory.

Workflow

digraph xml_config_migrating {
    "Skill invoked" [shape=doublecircle];
    "Step 1: Inventory (inventory.sh)" [shape=box];
    "Inventory empty?" [shape=diamond];
    "STOP — report: nothing to migrate" [shape=octagon, style=filled, fillcolor=red, fontcolor=white];
    "Step 2: Baseline dumps" [shape=box];
    "Step 3: Migrate one XML file to one PHP file" [shape=box];
    "Step 4: Import pre-check (check-class-imports.sh)" [shape=box];
    "Imports complete?" [shape=diamond];
    "Step 5: Add the missing imports" [shape=box];
    "Step 6: After dumps" [shape=box];
    "Step 7: Verify (verify-dumps.sh)" [shape=box];
    "verify-dumps.sh exit 0?" [shape=diamond];
    "Step 8: Fix the PHP file" [shape=box];
    "Step 9: Tests and deprecation gate" [shape=box];
    "Tests and gate pass?" [shape=diamond];
    "Step 10: Report" [shape=box];
    "Report: migration verified" [shape=doublecircle];
    "Report: NOT done" [shape=doublecircle];

    "Skill invoked" -> "Step 1: Inventory (inventory.sh)";
    "Step 1: Inventory (inventory.sh)" -> "Inventory empty?";
    "Inventory empty?" -> "STOP — report: nothing to migrate" [label="yes"];
    "Inventory empty?" -> "Step 2: Baseline dumps" [label="no"];
    "Step 2: Baseline dumps" -> "Step 3: Migrate one XML file to one PHP file";
    "Step 3: Migrate one XML file to one PHP file" -> "Step 4: Import pre-check (check-class-imports.sh)";
    "Step 4: Import pre-check (check-class-imports.sh)" -> "Imports complete?";
    "Imports complete?" -> "Step 5: Add the missing imports" [label="no"];
    "Step 5: Add the missing imports" -> "Step 4: Import pre-check (check-class-imports.sh)";
    "Imports complete?" -> "Step 6: After dumps" [label="yes"];
    "Step 6: After dumps" -> "Step 7: Verify (verify-dumps.sh)";
    "Step 7: Verify (verify-dumps.sh)" -> "verify-dumps.sh exit 0?";
    "verify-dumps.sh exit 0?" -> "Step 8: Fix the PHP file" [label="no"];
    "Step 8: Fix the PHP file" -> "Step 6: After dumps";
    "verify-dumps.sh exit 0?" -> "Step 9: Tests and deprecation gate" [label="yes"];
    "Step 9: Tests and deprecation gate" -> "Tests and gate pass?";
    "Tests and gate pass?" -> "Report: NOT done" [label="no"];
    "Tests and gate pass?" -> "Step 10: Report" [label="yes"];
    "Step 10: Report" -> "Report: migration verified";
}