PHPackages                             shopsys/migrations - 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. [Database &amp; ORM](/categories/database)
4. /
5. shopsys/migrations

ActiveLibrary[Database &amp; ORM](/categories/database)

shopsys/migrations
==================

Symfony bundle providing commands for transactional Doctrine database migrations

v19.0.0(1mo ago)3256.0k↓44.7%120MITPHPPHP ^8.5CI passing

Since Feb 29Pushed 5d ago7 watchersCompare

[ Source](https://github.com/shopsys/migrations)[ Packagist](https://packagist.org/packages/shopsys/migrations)[ RSS](/packages/shopsys-migrations/feed)WikiDiscussions 20.0 Synced 3d ago

READMEChangelogDependencies (29)Versions (230)Used By (20)

About
-----

[](#about)

[![Downloads](https://camo.githubusercontent.com/5c962d7ab33fdc48d2af78239f5d1de6de5bc999ef89d92959a21cfa3747e5fb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73686f707379732f6d6967726174696f6e732e737667)](https://packagist.org/packages/shopsys/migrations)

This bundle provides commands which can be useful for database migrations:

- `shopsys:migrations:check-mapping` checks if ORM mapping is valid.
- `shopsys:migrations:check-schema` checks if database schema is satisfying ORM.
- `shopsys:migrations:count` returns count of migrations to execute.
- `shopsys:migrations:migrate` executes all database migrations in one transaction.
    - the command supports installing migrations from multiple sources, so every bundle can have its own migrations
    - it creates a `migration-lock.yml` file in the project's root, persisting the order of execution
    - migrations can be manually reordered or skipped if necessary
- `shopsys:migrations:generate` generates database migrations if the schema was changed
    - the command does not generate migrations that break backwards compatibility - eg. column dropping
    - prompts you to choose the location for migration file if you are developing more than one bundle

This bundle uses [DoctrineMigrationsBundle](https://symfony.com/doc/current/bundles/DoctrineMigrationsBundle), so you have to install both.

This repository is maintained by shopsys/shopsys monorepo, information about changes is in its `CHANGELOG` file.

To be able to use this bundle, you need to do following:
--------------------------------------------------------

[](#to-be-able-to-use-this-bundle-you-need-to-do-following)

1. Require `shopsys/migrations` in `composer.json`
2. Register bundles in your `AppKernel.php`:

    ```
    new Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle(),
    new Shopsys\MigrationBundle\ShopsysMigrationBundle(),

    ```
3. Configure `DoctrineMigrationsBundle` according to its documentation (see )

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

[](#contributing)

Thank you for your contributions to Shopsys Migrations package. Together we are making Shopsys Platform better.

This repository is READ-ONLY. If you want to [report issues](https://github.com/shopsys/shopsys/issues/new) and/or send [pull requests](https://github.com/shopsys/shopsys/compare), please use the main [Shopsys repository](https://github.com/shopsys/shopsys).

Please check our [Contribution Guide](https://github.com/shopsys/shopsys/blob/HEAD/CONTRIBUTING.md) before contributing.

Support
-------

[](#support)

What to do when you are in troubles or need some help? The best way is to join our [Slack](https://join.slack.com/t/shopsysframework/shared_invite/zt-11wx9au4g-e5pXei73UJydHRQ7nVApAQ).

If you want to [report issues](https://github.com/shopsys/shopsys/issues/new), please use the main [Shopsys repository](https://github.com/shopsys/shopsys).

###  Health Score

71

—

ExcellentBetter than 100% of packages

Maintenance96

Actively maintained with recent releases

Popularity38

Limited adoption so far

Community38

Small or concentrated contributor base

Maturity100

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

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 ~39 days

Total

96

Last Release

18d ago

Major Versions

14.0.x-dev → 16.0.x-dev2024-12-30

0.0.x-dev → 17.0.x-dev2025-09-10

v14.5.0 → 18.0.x-dev2025-12-29

14.5.x-dev → 19.0.x-dev2026-05-26

v19.0.0 → 20.0.x-dev2026-06-16

PHP version history (8 changes)v1.0.0PHP 5.6.\*

v1.4.2PHP ^5.6 || ^7.0

v7.0.0-alpha1PHP ^5.6|^7.0

v7.0.0-alpha2PHP ^7.1

v8.0.0PHP ^7.2

v10.0.0PHP ^8.1

v14.0.0PHP ^8.3

19.0.x-devPHP ^8.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5638367?v=4)[Tomáš Ludvik](/maintainers/TomasLudvik)[@TomasLudvik](https://github.com/TomasLudvik)

![](https://avatars.githubusercontent.com/u/1177414?v=4)[Martin Grossmann](/maintainers/grossmannmartin)[@grossmannmartin](https://github.com/grossmannmartin)

![](https://www.gravatar.com/avatar/8aee0045853dd983a2a4f291d2e21e7492e2d8c19d84cdb7a76dd16c3eb499f9?d=identicon)[rostislav.vitek@shopsys.com](/maintainers/rostislav.vitek@shopsys.com)

![](https://www.gravatar.com/avatar/0a44b48b2c3e7114fdf1cbdf9170494591abad48f5fc416d93b134abd771635f?d=identicon)[Miroslav Stopka](/maintainers/Miroslav%20Stopka)

---

Top Contributors

[![TomasLudvik](https://avatars.githubusercontent.com/u/5638367?v=4)](https://github.com/TomasLudvik "TomasLudvik (95 commits)")[![vitek-rostislav](https://avatars.githubusercontent.com/u/10401898?v=4)](https://github.com/vitek-rostislav "vitek-rostislav (85 commits)")[![grossmannmartin](https://avatars.githubusercontent.com/u/1177414?v=4)](https://github.com/grossmannmartin "grossmannmartin (80 commits)")[![PetrHeinz](https://avatars.githubusercontent.com/u/10008612?v=4)](https://github.com/PetrHeinz "PetrHeinz (50 commits)")[![pesektomas](https://avatars.githubusercontent.com/u/1737966?v=4)](https://github.com/pesektomas "pesektomas (12 commits)")[![sustmi](https://avatars.githubusercontent.com/u/885946?v=4)](https://github.com/sustmi "sustmi (12 commits)")[![boris-brtan](https://avatars.githubusercontent.com/u/39240194?v=4)](https://github.com/boris-brtan "boris-brtan (9 commits)")[![s3tezsky](https://avatars.githubusercontent.com/u/53976269?v=4)](https://github.com/s3tezsky "s3tezsky (9 commits)")[![DavidOstrozlik](https://avatars.githubusercontent.com/u/44843673?v=4)](https://github.com/DavidOstrozlik "DavidOstrozlik (7 commits)")[![miroslav2stopka](https://avatars.githubusercontent.com/u/35224208?v=4)](https://github.com/miroslav2stopka "miroslav2stopka (7 commits)")[![RobinDvorak](https://avatars.githubusercontent.com/u/7197178?v=4)](https://github.com/RobinDvorak "RobinDvorak (5 commits)")[![henzigo](https://avatars.githubusercontent.com/u/1482966?v=4)](https://github.com/henzigo "henzigo (5 commits)")[![Miroslav-Stopka](https://avatars.githubusercontent.com/u/35930284?v=4)](https://github.com/Miroslav-Stopka "Miroslav-Stopka (4 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (3 commits)")[![sspooky13](https://avatars.githubusercontent.com/u/25614491?v=4)](https://github.com/sspooky13 "sspooky13 (2 commits)")[![pk16011990](https://avatars.githubusercontent.com/u/5857836?v=4)](https://github.com/pk16011990 "pk16011990 (2 commits)")[![msshopsys](https://avatars.githubusercontent.com/u/128610012?v=4)](https://github.com/msshopsys "msshopsys (2 commits)")[![LukasHeinz](https://avatars.githubusercontent.com/u/33071107?v=4)](https://github.com/LukasHeinz "LukasHeinz (2 commits)")[![stanoMilan](https://avatars.githubusercontent.com/u/35031880?v=4)](https://github.com/stanoMilan "stanoMilan (1 commits)")[![ondrejmirtes](https://avatars.githubusercontent.com/u/104888?v=4)](https://github.com/ondrejmirtes "ondrejmirtes (1 commits)")

---

Tags

schemadatabaseormdoctrinemigrationsmigrate

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/shopsys-migrations/health.svg)

```
[![Health](https://phpackages.com/badges/shopsys-migrations/health.svg)](https://phpackages.com/packages/shopsys-migrations)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M508](/packages/pimcore-pimcore)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M203](/packages/sulu-sulu)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M572](/packages/shopware-core)

PHPackages © 2026

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