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 Doctrine Migrations library emits a series of events during the migration process.

  • onMigrationsMigrating: dispatched immediately before starting to execute versions. This does not fire if

there are no versions to be executed. - onMigrationsVersionExecuting: dispatched before a single version executes. - onMigrationsVersionExecuted: dispatched after a single version executes. - onMigrationsVersionSkipped: dispatched when a single version is skipped. - onMigrationsMigrated: dispatched when all versions have been executed.

All of these events are emitted via the DBAL 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\Migrations\Event\MigrationsEventArgs;
use Doctrine\Migrations\Event\MigrationsVersionEventArgs;
use Doctrine\Migrations\Events;

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

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

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

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

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

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


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


44


45

To add an event subscriber to a connections event manager, use the Connection::getEventManager() method and the EventManager::addEventSubscriber() method:

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;

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

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

// rest of the cli set up...


2


3


4


5


6


7


8


9


10


11

Next Chapter: Version Numbers