PHPackages                             webgriffe/sylius-upgrade-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. webgriffe/sylius-upgrade-plugin

ActiveSylius-plugin[Utility & Helpers](/categories/utility)

webgriffe/sylius-upgrade-plugin
===============================

Helps you upgrade your Sylius app to a new version.

v2.0.1(3mo ago)13103.1k↓35.7%1[4 issues](https://github.com/webgriffe/SyliusUpgradePlugin/issues)MITPHPPHP ^8.2CI failing

Since May 10Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/webgriffe/SyliusUpgradePlugin)[ Packagist](https://packagist.org/packages/webgriffe/sylius-upgrade-plugin)[ RSS](/packages/webgriffe-sylius-upgrade-plugin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (38)Versions (23)Used By (0)

 [ ![](https://camo.githubusercontent.com/1567208cc7c8ec53cf6e2af4f54449a9bb3ab0dee7916998de4e3ce9b7f79015/68747470733a2f2f64656d6f2e73796c6975732e636f6d2f6173736574732f73686f702f696d672f6c6f676f2e706e67) ](https://sylius.com)

Upgrade Plugin
==============

[](#upgrade-plugin)

This plugin helps you to upgrade your Sylius app to a new version.

[![Build Status](https://github.com/webgriffe/SyliusUpgradePlugin/workflows/Build/badge.svg)](https://github.com/webgriffe/SyliusUpgradePlugin/actions)

Table of Contents
-----------------

[](#table-of-contents)

- [Table of Contents](#table-of-contents)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [License](#license)
- [Credits](#credits)

Requirements
------------

[](#requirements)

- PHP `^8.0`
- Sylius `^1.11.2 || ^1.12 || ^1.13`

Installation
------------

[](#installation)

1. Run `composer require --dev webgriffe/sylius-upgrade-plugin`
2. Add the plugin to the `config/bundles.php` file:

    ```
    Webgriffe\SyliusUpgradePlugin\WebgriffeSyliusUpgradePlugin::class => ['dev' => true, 'test' => true],
    ```

Usage
-----

[](#usage)

All features are implemented as **console commands**.

### Template changes

[](#template-changes)

```
bin/console webgriffe:upgrade:template-changes   [--theme=PATH_TO_YOUR_THEME] [--legacy]

```

Print a list of template files (with extension .html.twig) that changed between two given Sylius versions and that have been overridden in your project: in root "templates" folder and/or in a custom theme.

You have to specify both the versions **from** and **to** you want to compute the changes.

There are two optional parameters:

- **--theme=PATH\_TO\_YOUR\_THEME**, specify the theme folder in which to search for changed files. The path must be relative to the **kernel.project\_dir** of your project. You can specify multiple themes by repeating the **--theme** parameter, see the related example in the proper section below;
- **--legacy**, use legacy theme folder structure. From v2.0 of the [SyliusThemeBundle](https://github.com/Sylius/SyliusThemeBundle/) the theme folder structure has changed. The old structure has been deprecated and will be removed in v3.0 as stated [here](https://github.com/Sylius/SyliusThemeBundle/blob/master/UPGRADE.md#upgrade-from-1x-to-20).

#### Examples

[](#examples)

- List of templates that changed between Sylius v1.8.4 and v1.8.8 and that were overridden in your root **templates** folder:

    ```
    bin/console webgriffe:upgrade:template-changes v1.8.4 v1.8.8
    ```
- List of templates that changed between Sylius v1.8.8 and v1.9.3 and that were overridden in your root **templates** folder and/or in your **my-website-theme** folder:

    ```
    bin/console webgriffe:upgrade:template-changes v1.8.8 v1.9.3 --theme=themes/my-website-theme
    ```
- Like the previous example, but it computes changes for multiple themes, one of which is in the vendor folder:

    ```
    bin/console webgriffe:upgrade:template-changes v1.8.8 v1.9.3 --theme=themes/my-website-theme --theme=themes/my-other-theme --theme=vendor/acme/my-vendor-theme
    ```

### Decorated services changes

[](#decorated-services-changes)

```
bin/console webgriffe:upgrade:service-changes   [--theme=PATH_TO_YOUR_THEME] [--legacy]

```

Print a list of services that changed between two given Sylius versions and that have been decorated/overridden in your project.

You have to specify both the versions **from** and **to** you want to compute the changes.

There are two optional parameters:

- **--namespace-prefix=NAMESPACE-PREFIX**, the first part of the namespace of your app services, like "App" in "App\\Calculator\\PriceCalculator". Default: "App".
- **--alias-prefix=ALIAS-PREFIX**, the first part of the alias of your app services, like "app" in "app.calculator.price". Default: "app".

#### Examples

[](#examples-1)

- List of services that changed between Sylius v1.11.0 and v1.13.0 and that were decorated in your project:

    ```
    bin/console webgriffe:upgrade:service-changes v1.11.0 v1.13.0
    ```
- List of services that changed between Sylius v1.11.0 and v1.13.0 and that were decorated in your project but with custom namespace and alias prefixes:

    ```
    bin/console webgriffe:upgrade:service-changes v1.11.0 v1.13.0 --namespace-prefix="Webgriffe" --alias-prefix="webgriffe"
    ```

Contributing
------------

[](#contributing)

To contribute to this plugin clone this repository, create a branch for your feature or bugfix, do your changes and then make sure al tests are passing.

```
```bash
$ (cd tests/Application && yarn install)
$ (cd tests/Application && yarn build)
$ (cd tests/Application && APP_ENV=test bin/console assets:install public)

$ (cd tests/Application && APP_ENV=test bin/console doctrine:database:create)
$ (cd tests/Application && APP_ENV=test bin/console doctrine:schema:create)
```

```

To be able to setup a plugin's database, remember to configure you database credentials in `tests/Application/.env` and `tests/Application/.env.test`.

### Running plugin tests

[](#running-plugin-tests)

- PHPUnit

    ```
    vendor/bin/phpunit
    ```
- PHPSpec

    ```
    vendor/bin/phpspec run
    ```
- Static Analysis

    - Psalm

        ```
        vendor/bin/psalm
        ```
    - PHPStan

        ```
        vendor/bin/phpstan analyse
        ```
- Coding Standard

    ```
    vendor/bin/ecs check
    ```

License
-------

[](#license)

This plugin is under the MIT license. See the complete license in the LICENSE file.

Credits
-------

[](#credits)

Developed by [Webgriffe®](https://www.webgriffe.com/).

###  Health Score

54

—

FairBetter than 97% of packages

Maintenance74

Regular maintenance activity

Popularity39

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 69.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~157 days

Recently: every ~182 days

Total

12

Last Release

105d ago

Major Versions

v0.6.1 → v1.0.02024-02-05

v1.1.1 → v2.0.02025-09-19

PHP version history (4 changes)0.1.0PHP ^7.3

0.2.0PHP ^7.4 || ^8.0

v0.6.0PHP ^8.0

v2.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/eca104631fd7f6aff6d399ca16458c4d9814770756af0ecca22ffe2b1c5704d3?d=identicon)[mmenozzi](/maintainers/mmenozzi)

---

Top Contributors

[![LucaGallinari](https://avatars.githubusercontent.com/u/5822554?v=4)](https://github.com/LucaGallinari "LucaGallinari (88 commits)")[![lruozzi9](https://avatars.githubusercontent.com/u/26346480?v=4)](https://github.com/lruozzi9 "lruozzi9 (36 commits)")[![mmenozzi](https://avatars.githubusercontent.com/u/1199914?v=4)](https://github.com/mmenozzi "mmenozzi (2 commits)")[![stefandoorn](https://avatars.githubusercontent.com/u/4903082?v=4)](https://github.com/stefandoorn "stefandoorn (1 commits)")

---

Tags

syliustemplatethemesyliussylius-plugin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/webgriffe-sylius-upgrade-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/webgriffe-sylius-upgrade-plugin/health.svg)](https://phpackages.com/packages/webgriffe-sylius-upgrade-plugin)
```

###  Alternatives

[sylius/refund-plugin

Plugin provides basic refunds functionality for Sylius application.

691.7M14](/packages/sylius-refund-plugin)[stefandoorn/sitemap-plugin

Sitemap Plugin for Sylius

851.0M](/packages/stefandoorn-sitemap-plugin)[monsieurbiz/sylius-rich-editor-plugin

A Rich Editor plugin for Sylius.

75380.8k6](/packages/monsieurbiz-sylius-rich-editor-plugin)[synolia/sylius-gdpr-plugin

Synolia sylius GDPR plugin.

20148.1k](/packages/synolia-sylius-gdpr-plugin)[synolia/sylius-scheduler-command-plugin

Scheduler Command Plugin.

34361.5k](/packages/synolia-sylius-scheduler-command-plugin)[odiseoteam/sylius-blog-plugin

This plugin add blog capabilities to your Sylius project

37104.5k](/packages/odiseoteam-sylius-blog-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)