You are browsing a version that is no longer maintained.
Maintained
4.0 (upcoming) 3.9 (upcoming) 3.8.2 (current)
Unmaintained
3.7 3.6 3.5 3.4 3.3 3.2 3.1 3.0 2.3 2.2 2.1 2.0 1.8 1.7

Migrations Events

The migrations library emits a series of events during the migration process.

  • onMigrationsMigrating: fired immediately before starting to execute versions. This does not fire if there are no versions to be executed.
  • onMigrationsVersionExecuting: fired before a single version executes.
  • onMigrationsVersionExecuted: fired after a single version executes.
  • onMigrationsVersionSkipped: fired when a single version is skipped.
  • onMigrationsMigrated: fired when all versions have been executed.

All of these events are emitted via the connection's event manager. Here's an example event subscriber that listens for all possible migrations events.

1<?php
use Doctrine\Common\EventSubscriber;
use Doctrine\DBAL\Migrations\Event\MigrationsEventArgs;
use Doctrine\DBAL\Migrations\Event\MigrationsVersionEventArgs;

class MigrationsListener implements EventSubscriber
{
    public function getSubscribedEvents()
    {
        return [
            Events::onMigrationsMigrating,
            Events::onMigrationsMigrated,
            Events::onMigrationsVersionExecuting,
            Events::onMigrationsVersionExecuted,
            Events::onMigrationsVersionSkipped,
        ];
    }

    public function onMigrationsMigrating(MigrationsEventArgs $args)
    {
        // ...
    }

    public function onMigrationsMigrated(MigrationsEventArgs $args)
    {
        // ...
    }

    public function onMigrationsVersionExecuting(MigrationsVersionEventArgs $args)
    {
        // ...
    }

    public function onMigrationsVersionExecuted(MigrationsVersionEventArgs $args)
    {
        // ...
    }

    public function onMigrationsVersionSkipped(MigrationsVersionEventArgs $args)
    {
        // ...
    }
}


2


3


4


5


6


7


8


9


10


11


12


13


14


15


16


17


18


19


20


21


22


23


24


25


26


27


28


29


30


31


32


33


34


35


36


37


38


39


40


41


42


43

To hook a migrations event subscriber into a connection, use its event manager. This might go in the cli-config.php file or somewhere in a frameworks container or dependency injection configuration.

1<?php
use Doctrine\DBAL\DriverManager;

$conn = DriverManager::getConnection([
  // ...
]);

$conn->getEventManager()->addEventSubscriber(new MigrationsListener());

// rest of the cli set up...


2


3


4


5


6


7


8


9


10