# doctrine/migrations

Doctrine Database Migrations Library

Repository: https://github.com/doctrine/migrations
Canonical: https://ross.abutalabs.com/products/migrations
Homepage: https://www.doctrine-project.org/projects/migrations.html
Language: PHP
License: MIT
License Family: permissive
Last push: 2026-06-19T05:26:15+00:00

## Health v2 (maintenance only)
Score: 83/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 88, release rhythm 68, longevity 100
- inputs: {"age_days": 6007, "days_push": 75, "days_rel": 132, "gap_med": 71, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4768, forks 393 (observed 2026-08-28T04:08:59.329888+00:00)

## What it is
Doctrine Migrations is a PHP library built on top of Doctrine DBAL for versioning database schemas and deploying schema changes. It provides migration classes and CLI commands to generate, run, and roll back database migrations.

## Use cases
- version a database schema in PHP projects
- run and roll back database migrations from the CLI
- deploy schema changes across environments
- generate migration files from Doctrine ORM schema changes
- track applied migrations in a database table

## When to choose
- you use Doctrine ORM/DBAL in a PHP project and need schema migrations
- you want repeatable, version-controlled database schema changes
- you need a Symfony-integrated migration workflow via DoctrineMigrationsBundle

## When to avoid
- your project uses a non-PHP stack or another ORM with its own migration tooling
- you only need raw SQL executed manually without version tracking
- you want framework-agnostic migrations outside the Doctrine ecosystem

## Facets
- artifact type: library
- maturity: stable
- function: database, deployment, cli, developer-tools
- domain: databases, developer-tools, backend, web-development
- platform: php, cli, cross-platform
- tags: database-migrations, schema-versioning, doctrine, dbal, sql

## Member repositories
- doctrine/migrations (main) score 83

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:59.329888+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:18:49.496541+00:00, confidence not recorded.
  - readme: https://github.com/doctrine/migrations (fetched 2026-08-28T04:08:59.329888+00:00, sha fac1fbf2112b)
  - homepage: https://www.doctrine-project.org/projects/migrations.html (fetched 2026-08-29T09:02:15.568201+00:00, sha a46517127ec9)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.9/index.html (fetched 2026-08-29T09:02:15.577715+00:00, sha 9566e3857a0c)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/4.0/index.html (fetched 2026-08-29T09:02:15.579588+00:00, sha a4b8ac7974c0)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.10/index.html (fetched 2026-08-29T09:02:15.581246+00:00, sha a9ec8592e077)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.8/index.html (fetched 2026-08-29T09:02:15.582822+00:00, sha 4ef0a762c886)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.7/index.html (fetched 2026-08-29T09:02:15.584433+00:00, sha ce42052d9026)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.6/index.html (fetched 2026-08-29T09:02:15.586024+00:00, sha 3b08cc5ae62c)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.5/index.html (fetched 2026-08-29T09:02:15.587661+00:00, sha 53546c09abef)
  - site_page: https://www.doctrine-project.org/projects/doctrine-migrations/en/3.4/index.html (fetched 2026-08-29T09:02:15.589241+00:00, sha 07c9a6a9fa0b)
- Data as of 2026-08-30T08:39:29.467469+00:00.