Doctrine ORM 2 end-of-life
Doctrine ORM 2.x bereikt end-of-life in februari 2027. ORM 3 is sinds begin 2024 de onderhouden major en is wat huidige DoctrineBundle-, API Platform 4- en Symfony 7.4-projecten verwachten.
Wat ORM 3 verwijdert
- Annotation-mapping.
@ORM\Entityen consorten zijn weg; mapping is attributes, XML of PHP. doctrine/annotations zelf is verlaten. Dit is het grootste deel van het werk en precies wat de Doctrine-set van Rector automatiseert. - DBAL 2 en de meeste legacy-API's uit DBAL 3. Custom DBAL-types hebben de nieuwe signatures nodig, de resultaatafhandeling van
Statement::execute()is veranderd, platform-klassen zijn hernoemd. flush($entity),EntityManager::create(),Setup::createAnnotationMetadataConfiguration(), de oude proxy-generatie en een reeks lifecycle-event-signatures.- Lazy ghost objects vervangen de oude proxies (Symfony's VarExporter). Code die op proxy-klassenamen of
__load()leunde, verdient aandacht.
Waarom het samenvalt met de Symfony-upgrade
ORM 3 vereist Symfony 7 niet. Het draait prima op Symfony 6.4 met DoctrineBundle 2.11 of nieuwer. Maar de overstap van annotations naar attributes is dezelfde die Symfony 7-routing, API Platform 3 en PHPUnit 12 vereisen, dus die één keer doen voor alle vier is de efficiënte volgorde. De meeste 5.4- en 6.4-codebases doen het als tweede PR van hun upgrade, direct na de deprecations.
Volgorde
- Annotations → attributes met Rector, op de huidige ORM-versie. Zelfstandig deploybaar.
- DBAL 3 → 4: custom types en ruwe SQL-resultaatafhandeling corrigeren.
- ORM 2.19 → 3.x: eerst deprecations (2.19 logt ze), dan de major.
- Migrations-diff opnieuw genereren om te bevestigen dat het schema niet is veranderd.
Als vaste-prijs-add-on kost de ORM-upgrade €1.500 tot €3.500, afhankelijk van het aantal entities, custom types en ruwe DBAL-aanroepen. Zie diensten en prijzen.
Waar staat jouw applicatie?
Upload je composer.lock en krijg binnen seconden je upgradepad, de pakketten die het blokkeren en een readiness-score. Gratis, geen account, geen broncode.
Data geverifieerd op 2026-09-09 aan de hand van de officiële release-pagina's. Andere deadlines: API Platform 3 end-of-life · Symfony 6.4 end-of-life · Symfony 5.4 end-of-life · alle end-of-life-data. Ook beschikbaar in English Deutsch