README

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

License

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

imt / doctrine-migrations-multi

Maintainers

Details