PHPackages                             gheb/data-migrations-bundle - 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 & ORM](/categories/database)
4. /
5. gheb/data-migrations-bundle

AbandonedArchivedSymfony-bundle[Database & ORM](/categories/database)

gheb/data-migrations-bundle
===========================

Migrate your data along side your data structure.

1.4.3(6y ago)44.6k1MITPHPPHP >=7.1.0

Since Dec 4Pushed 5y ago1 watchersCompare

[ Source](https://github.com/GregoireHebert/data-migrations-bundle)[ Packagist](https://packagist.org/packages/gheb/data-migrations-bundle)[ RSS](/packages/gheb-data-migrations-bundle/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (13)Versions (10)Used By (0)

❗ ❗

This Bundle has been useful, but is not necessary anymore since Doctrine Migrations Bundle 2.2. Prefer using multiple directories from doctrine migrations bundle :)

I won't maintain this bundle anymore :) Thank you all !

DataMigrationsBundle
====================

[](#datamigrationsbundle)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![Build Status](https://camo.githubusercontent.com/b7973b5714c70f76c56fe012911b74ca979dde7e580af67f2347be6b839925a8/68747470733a2f2f7472617669732d63692e636f6d2f477265676f6972654865626572742f646174612d6d6967726174696f6e732d62756e646c652e7376673f6272616e63683d312e33)](https://travis-ci.com/GregoireHebert/data-migrations-bundle)

This bundle is the missing piece of the [Doctrine2 Migrations bundle](https://symfony.com/doc/master/bundles/DoctrineMigrationsBundle/index.html)into Symfony applications. Data migrations help you version the changes in your data, and apply them in a predictable way on every server running the application.

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

[](#installation)

```
$ composer require gheb/data-migrations-bundle
```

The library can be found at `vendor/gheb/DataMigrationsBundle`. Finally, be sure to enable the bundle in `AppKernel.php` by including the following:

```
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        //...
        new Gheb\DataMigrationsBundle\DataMigrationsBundle(),
    );
}
```

Configuration
-------------

[](#configuration)

You can configure the path, namespace, table\_name, name, organize\_migrations and custom\_template in your `config.yml`. The examples below are the default values.

```
# app/config/config.yml
data_migrations:
    dir_name: "%kernel.root_dir%/DataMigrations"
    namespace: "Application\\Migrations"
    table_name: "data_migration_versions"
    name: Application Data Migrations
    organize_migrations: false # Possible values are: "BY_YEAR", "BY_YEAR_AND_MONTH", false
    custom_template: ~ # Path to your custom migrations template
```

Usage
-----

[](#usage)

### Caution

[](#caution)

```
If your application is based on Symfony 3, replace `php app/console` by `php bin/console` before executing any of the console commands included
in this article.

```

All of the migrations functionality is contained in a few console commands:

```
 gheb:data-migrations:execute             [execute] Execute a single migration version up or down manually.
 gheb:data-migrations:generate            [generate] Generate a blank migration class.
 gheb:data-migrations:latest              [latest] Outputs the latest version number
 gheb:data-migrations:migrate             [migrate] Execute a migration to a specified version or the latest available version.
 gheb:data-migrations:status              [status] View the status of a set of migrations.
 gheb:data-migrations:version             [version] Manually add and delete migration versions from the version table.
```

Documentation
-------------

[](#documentation)

This bundle is based on the doctrine migrations bundle. If you need more information, please refer to the [original bundle documentation](https://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html).

Running tests & cs checks
-----------------------------

[](#running-tests--cs-checks)

`$ ./vendor/bin/phpunit --bootstrap vendor/autoload.php --testdox tests``$ ./vendor/bin/php-cs-fixer fix --config .php_cs.dist --verbose --dry-run src`

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~44 days

Recently: every ~1 days

Total

9

Last Release

2404d ago

PHP version history (2 changes)1.3.2PHP >=5.4.0 <7.3

1.4.0PHP >=7.1.0

### Community

Maintainers

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

---

Top Contributors

[![GregoireHebert](https://avatars.githubusercontent.com/u/878701?v=4)](https://github.com/GregoireHebert "GregoireHebert (14 commits)")

---

Tags

datadbalmigrations

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/gheb-data-migrations-bundle/health.svg)

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

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M373](/packages/easycorp-easyadmin-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1615.6k12](/packages/2lenet-crudit-bundle)

PHPackages © 2026

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