Sylius Upgrade Analyzer

What it does

Sylius Upgrade Analyzer scans your existing Sylius 1.x project, detects every breaking change, deprecated API, and incompatible pattern from the official UPGRADE-2.0.md, UPGRADE-API-2.0.md and CHANGELOG-2.0.md, then produces a detailed migration report with time estimates and fix suggestions.

49 Built-in Analyzers

• Templates & Frontend (6): Twig template overrides, Sonata block events, Semantic UI classes, jQuery usage, Webpack Encore detection, use_webpack config removal
• Deprecations & Breaking Changes (35): Winzou state machine, SwiftMailer, user encoders, Payum gateways, message bus renames, command handler renames, removed email managers, removed payment gateways, service decorators, order processor priorities, form type extensions, Behat contexts, admin menu events, translation keys, promotion rules, shipping calculators, Doctrine XML mapping, custom fixtures, multi-store channels, bundle configuration, calendar-to-clock, security firewalls, user model fields, removed classes (150+), renamed service IDs, removed routes, LiipImagine config, constructor signatures, removed config keys, routing imports, PHP/Node versions, class moves, service visibility, payment request env vars, deprecated bundle packages
• Plugins (1): Cross-references installed plugins with the Sylius Addons Marketplace API and Packagist
• Grid & Resource (3): Custom grid YAML/PHP, resource bundle config, grid filter entity syntax
• API Platform (4): API Platform migration, serialization groups, endpoint restructuring, query extension signatures

41 Auto-Fixers

The tool can automatically apply fixes for the most common migration patterns. Each fix has a confidence level (HIGH, MEDIUM, LOW) to help you decide whether to apply it automatically or review manually.

6 Output Formats

Console (with colored output), JSON, CSV, SARIF (GitHub Code Scanning compatible), Markdown, and PDF (via the web service).

Additional Features

• Custom rules via .sylius-upgrade-rules.yaml
• Baseline management — save and diff results across runs
• Sprint planner — generate a migration roadmap with sprint breakdown
• Plugin compatibility matrix
• GitHub Action for CI/CD integration
• Risk scoring (low / moderate / high / critical)

Installation

composer require --dev pierre-arthur/sylius-upgrade-analyzer

Quick Start

vendor/bin/sylius-upgrade-analyzer sylius-upgrade:analyze
vendor/bin/sylius-upgrade-analyzer sylius-upgrade:analyze --fix --dry-run
vendor/bin/sylius-upgrade-analyzer sylius-upgrade:analyze --format=json
--output=report.json

Requirements

PHP 8.2+, Symfony 6.4 or 7.2.