README.md

doctrine-migrations-multi

Overview

This repository provides a simple script that adds the ability to use Doctrine Migrations with more than one (multiple) connection (database).

Installation

1. Using Composer (recommended)

To install doctrine-migrations-multi with Composer just add the following to your composer.json file:

{
    "require": {
        "imt/doctrine-migrations-multi": "0.9.*"
    }
}

Then, you can install the new dependencies by running Composer's update command from the directory where your composer.json file is located:

$ php composer.phar update imt/doctrine-migrations-multi

Now, Composer will automatically download all required files, and install them for you.

Usage

To start using doctrine-migrations-multi create the migrations-db-multi.php file that returns an array of connections:

migrations-db-multi-example.php

<?php

return [
    'foo' => [
        'dbname'   => 'foo',
        'user'     => 'foo',
        'password' => 'foo',
        'host'     => 'localhost',
        'driver'   => 'pdo_mysql'
    ],
    'bar' => [
        'dbname'   => 'bar',
        'user'     => 'bar',
        'password' => 'bar',
        'host'     => 'localhost',
        'driver'   => 'pdo_mysql'
    ],
];

Then, run doctrine-migrations-multi with needed command (for instance with migrations:migrate):

php vendor/bin/doctrine-migrations-multi \
    migrations:migrate \
    --configuration=<path-to>/migrations.yml \
    --connection=foo \
    --db-configuration-multi=<path-to>/migrations-db-multi.php

Testing

$ make test

Contributing

Please see CONTRIBUTING for details.

Credits

• Igor Timoshenko
• All Contributors

License

This library is released under the MIT license. See the complete license in the LICENSE file that is distributed with this source code.