formal/migrations

SQL and Commands migrations

2.0.0 2026-04-04 16:51 UTC

Requires

• php: ~8.4
• formal/orm: ~6.0
• innmind/foundation: ~2.1

Requires (Dev)

• innmind/black-box: ~6.5
• innmind/coding-standard: ~2.0
• innmind/static-analysis: ~1.3

MIT

• Baptiste Langlade

• database
• migrations
• sql
• cli
• commands

README

This library is a simple one way migration system.

You can run both SQL and Commands migrations.

Installation

composer require formal/migrations

Usage

use Formal\Migrations\{
    Factory,
    Failure,
}
use Innmind\OperatingSystem\Factory as OS;
use Innmind\Url\{
    Url,
    Path,
};

$dsn = Url::of('mysql://user:pwd@127.0.0.1:3306/database');

Factory::of(OS::build())
    ->storeVersionsInDatabase($dsn)
    ->unwrap()
    ->sql()
    ->files(Path::of('migrations/folder/'))
    ->migrate($dsn)
    ->match(
        static fn() => print('Everything has been migrated'),
        static fn(Failure $failure) => printf(
            'Migrations failed with the message : %s',
            $failure->error()->getMessage(),
        ),
    );

Documentation

Full documentation available here.