PHPackages                             o3-shop/shop-doctrine-migration-wrapper - 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. o3-shop/shop-doctrine-migration-wrapper

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

o3-shop/shop-doctrine-migration-wrapper
=======================================

O3-Shop database migrations using doctrine

v1.0.1(9mo ago)04.6k↓33.3%1GPL-3.0-onlyPHPPHP ^7.4 || ^8.0CI failing

Since Mar 5Pushed 9mo agoCompare

[ Source](https://github.com/o3-shop/shop-doctrine-migration-wrapper)[ Packagist](https://packagist.org/packages/o3-shop/shop-doctrine-migration-wrapper)[ RSS](/packages/o3-shop-shop-doctrine-migration-wrapper/feed)WikiDiscussions b-7.0.x Synced 1mo ago

READMEChangelog (1)Dependencies (9)Versions (3)Used By (1)

O3-Shop doctrine migration integration
======================================

[](#o3-shop-doctrine-migration-integration)

[![https://travis-ci.org/o3-shop/o3-shop-doctrine-migration-wrapper.svg?branch=master](https://camo.githubusercontent.com/571ba5f61dd60ff4898c7948e2afc5fa4a604cdd5ec2e60a528505eeb8bf462b/68747470733a2f2f7472617669732d63692e6f72672f6f332d73686f702f6f332d73686f702d646f637472696e652d6d6967726174696f6e2d777261707065722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/o3-shop/o3-shop-doctrine-migration-wrapper)Document: [https://docs.o3-shop.com/developer/en/6.2/development/modules\_components\_themes/module/database\_migration/index.html](https://docs.o3-shop.com/developer/en/6.2/development/modules_components_themes/module/database_migration/index.html)

Branch Compatibility
--------------------

[](#branch-compatibility)

- master branch is compatible with O3-Shop compilation master
- b-6.4.x branch is compatible with O3-Shop compilation 6.4.x
- b-6.3.x branch is compatible with O3-Shop compilation 6.3.x
- b-3.x branch is compatible with O3-Shop compilation 6.2.x
- b-1.x branch is compatible with O3-Shop compilations before 6.2.x

Description
-----------

[](#description)

O3-Shop uses database migrations for:

- eShop editions migration
- Project specific migrations
- Modules migrations

At the moment O3-Shop uses "Doctrine 2 Migrations" and it's integrated via O3-Shop migration components.

Doctrine Migrations runs migrations with a single configuration. But there was a need to run migration for one or all the projects and modules (CE, PR and a specific module). For this reason Doctrine Migration Wrapper was created.

Running migrations - CLI
------------------------

[](#running-migrations---cli)

Script to run migrations is installed within composer bin directory. It accepts two parameters:

- Doctrine Command
- Suite Type (CE, PR or a specific module\_id)

```
vendor/bin/oe-eshop-db_migrate
```

To get comprehensive information about Doctrine 2 Migrations and available commands as well, please see [official documentation](https://www.doctrine-project.org/projects/doctrine-migrations/en/2.2/index.html).

Example:

```
vendor/bin/oe-eshop-db_migrate migrations:migrate
```

This command will run all the migrations which are in O3-Shop specific directories. For example if you have migration tool will run migrations in this order:

- Community Edition migrations (executed always)
- Project specific migrations (executed always)
- Module migrations (executed when eShop has at least one module with migration)

### Suite Types (Generate migration for a single suite)

[](#suite-types-generate-migration-for-a-single-suite)

It is also possible to run migrations for specific suite by defining &lt;Suite\_Type&gt; parameter in the command. This variable defines what type of migration it is. There are 5 suite types:

- **PR** - For project specific migrations. It should be always used for project development.
- **CE** - Generates migration file for O3-Shop Community Edition. It's used for product development only.
- **&lt;module\_id&gt;** - Generates migration file for O3-Shop specific module. It’s used for module development only.

Example 1:

```
vendor/bin/oe-eshop-db_migrate migrations:generate
```

This command generates migration versions for all the suite types.

Example 2:

```
vendor/bin/oe-eshop-db_migrate migrations:generate CE
```

In this case it will be generated only for Community Edition in vendor/o3-shop/shop\_ce/migration directory.

### Use Migrations Wrapper without CLI

[](#use-migrations-wrapper-without-cli)

Doctrine Migration Wrapper is written in PHP and also could be used without command line interface. To do so:

- Create `Migrations` object with `MigrationsBuilder->build()`
- Call `execute` method with needed parameters

Bugs and Issues
---------------

[](#bugs-and-issues)

If you experience any bugs or issues, please report them in the section **O3-Shop (all versions)** of .

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance56

Moderate activity, may be stable

Popularity22

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 60% 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 ~871 days

Total

2

Last Release

293d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/53b105106ade5f151851db1839b344f7be04f17d881c49ca0f4da0867d5b2d82?d=identicon)[o3-shop](/maintainers/o3-shop)

---

Top Contributors

[![nlo-tronet](https://avatars.githubusercontent.com/u/206915827?v=4)](https://github.com/nlo-tronet "nlo-tronet (3 commits)")[![o3-shop-user](https://avatars.githubusercontent.com/u/115017537?v=4)](https://github.com/o3-shop-user "o3-shop-user (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/o3-shop-shop-doctrine-migration-wrapper/health.svg)

```
[![Health](https://phpackages.com/badges/o3-shop-shop-doctrine-migration-wrapper/health.svg)](https://phpackages.com/packages/o3-shop-shop-doctrine-migration-wrapper)
```

###  Alternatives

[doctrine/doctrine-migrations-bundle

Symfony DoctrineMigrationsBundle

4.3k177.9M537](/packages/doctrine-doctrine-migrations-bundle)[spatie/laravel-backup

A Laravel package to backup your application

6.0k21.8M191](/packages/spatie-laravel-backup)[bolt/core

🧿 Bolt Core

585142.5k54](/packages/bolt-core)[worksome/foggy

Foggy is a tool for making database dumps with some data removed/changed.

26571.7k1](/packages/worksome-foggy)[mnapoli/dbal-schema

DB schema manager for Doctrine DBAL

9732.9k1](/packages/mnapoli-dbal-schema)[psx/sql

Generate type-safe PHP classes from your database

1773.4k4](/packages/psx-sql)

PHPackages © 2026

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