Skip to content

Upgrading doctrine/orm 2 to 3

Breaking2.20.14 → 3.7.6Breaking215Security1Platform3Deprecated29New32Changed76Fixed89Other199

Full comparisonBack to doctrine/orm
BreakingUpgrade verdict

211 breaking changes and 3 platform requirement changes and a security fix.

In plain terms
  • XML mapping files are still checked for validity by default, but you can now turn that check off.
  • DQL queries can no longer use the partial object syntax.
  • The Notify change tracking policy is gone, so entities using it must switch to another policy.
  • The concrete table inheritance strategy is no longer supported.
Must act Top 5 of 244 that need code or config changes

doctrine/orm publishes an official migration guide for version 3. It covers more than the release notes do.

An upgrade guide ↗

PHP requirement changed in 3.0.0-beta1: ^7.1 || ^8.0 → ^8.1.

Adds symfony/polyfill-php86 ^1.37, symfony/var-exporter ^6.3.9 || ^7.0 || ^8.0.

Drops doctrine/cache, doctrine/common, symfony/polyfill-php72, symfony/polyfill-php80.

Moves doctrine/collections ^1.5 || ^2.1 → ^2.2 || ^3.1, doctrine/dbal ^2.13.1 || ^3.2 → ^3.8.2 || ^4, doctrine/event-manager ^1.2 || ^2 → ^2.1.1, doctrine/lexer ^2 || ^3 → ^3, doctrine/persistence ^2.4 || ^3 → ^3.3.1 || ^4, symfony/console ^4.2 || ^5.0 || ^6.0 || ^7.0 || ^8.0 → ^5.4 || ^6.0 || ^7.0 || ^8.0. Your build may pick other versions.

What you must change

Breaking211
Allows XML validation to be disabled while keeping it enabled by default.
3.0.0GitHub ReleaseSummarizedView source
Removes partial syntax in DQL.
3.0.0GitHub ReleaseSummarizedView source
Removes the Notify change tracking policy.
3.0.0GitHub ReleaseSummarizedView source
Removes concrete table inheritance.
3.0.0GitHub ReleaseSummarizedView source
Removes deprecated methods and classes.
3.0.0GitHub ReleaseSummarizedView source
Removes $entityAnnotationClasses and getReader().
$entityAnnotationClassesgetReader()
3.0.0GitHub ReleaseSummarizedView source
Removes InExpression.
InExpression
3.0.0GitHub ReleaseSummarizedView source
Removes the Annotation interface.
Annotation
3.0.0GitHub ReleaseSummarizedView source
Removes DriverChain.
DriverChain
3.0.0GitHub ReleaseSummarizedView source
Removes EntityManager::create().
EntityManager::create()
3.0.0GitHub ReleaseSummarizedView source
Removes SQL resultset mapping.
3.0.0GitHub ReleaseSummarizedView source
Removes last references to ClassMetadataInfo.
ClassMetadataInfo
3.0.0GitHub ReleaseSummarizedView source
Removes support for Type::canRequireSQLConversion().
Type::canRequireSQLConversion()
3.0.0GitHub ReleaseSummarizedView source
Drops support for persistence 2.
3.0.0GitHub ReleaseSummarizedView source
Removes the doctrine binary.
3.0.0GitHub ReleaseSummarizedView source
Removes console helper.
3.0.0GitHub ReleaseSummarizedView source
Removes support for ObjectManagerAware.
ObjectManagerAware
3.0.0GitHub ReleaseSummarizedView source
Removes support for entity namespace aliases.
3.0.0GitHub ReleaseSummarizedView source
Removes TreeWalkerChainIterator.
TreeWalkerChainIterator
3.0.0GitHub ReleaseSummarizedView source
Removes the Proxy marker interface.
Proxy
3.0.0GitHub ReleaseSummarizedView source
Removes quoting methods from ClassMetadata.
ClassMetadata
3.0.0GitHub ReleaseSummarizedView source
Removes various deprecated methods and properties.
3.0.0GitHub ReleaseSummarizedView source
Removes ability to merge detached entities.
3.0.0GitHub ReleaseSummarizedView source
Removes ability to flush the EM partially.
3.0.0GitHub ReleaseSummarizedView source
Removes ability to clear the UoW partially.
3.0.0GitHub ReleaseSummarizedView source
Removes support for Doctrine Cache.
3.0.0GitHub ReleaseSummarizedView source
Removes the deprecated Setup class.
Setup
3.0.0GitHub ReleaseSummarizedView source
Removes the deprecated Named and Native Queries in Metadata and EntityRepository.
EntityRepository
3.0.0GitHub ReleaseSummarizedView source
Removes MultiGetRegion and adds native types to Region implementations.
MultiGetRegionRegion
3.0.0GitHub ReleaseSummarizedView source
Removes old cache accessors and mutators from query classes.
3.0.0GitHub ReleaseSummarizedView source
Removes AbstractIdGenerator::generate() and adds native types to ID generators.
AbstractIdGenerator::generate()
3.0.0GitHub ReleaseSummarizedView source
Removes Configuration::ensureProductionSettings().
Configuration::ensureProductionSettings()
3.0.0GitHub ReleaseSummarizedView source
Removes support for Doctrine Cache in second level cache.
3.0.0GitHub ReleaseSummarizedView source
Removes the deprecated PHPDriver.
PHPDriver
3.0.0GitHub ReleaseSummarizedView source
Removes EntityManager::transactional().
EntityManager::transactional()
3.0.0GitHub ReleaseSummarizedView source
Removes Setup::registerAutoloadDirectory().
Setup::registerAutoloadDirectory()
3.0.0GitHub ReleaseSummarizedView source
Removes the Version class.
Version
3.0.0GitHub ReleaseSummarizedView source
Removes code generators.
3.0.0GitHub ReleaseSummarizedView source
Removes AbstractHydrator::hydrateRow().
AbstractHydrator::hydrateRow()
3.0.0GitHub ReleaseSummarizedView source
Removes Query::iterate().
Query::iterate()
3.0.0GitHub ReleaseSummarizedView source
Removes TABLE and UUID strategies.
3.0.0GitHub ReleaseSummarizedView source
Removes EntityManagerInterface::copy().
EntityManagerInterface::copy()
3.0.0GitHub ReleaseSummarizedView source
Removes ClassMetadataInfo.
ClassMetadataInfo
3.0.0GitHub ReleaseSummarizedView source
Drops doctrine/lexer 1.
3.0.0GitHub ReleaseSummarizedView source
Removes PHP 7 code.
3.0.0GitHub ReleaseSummarizedView source
Drops support for unserializing old serialization formats.
3.0.0GitHub ReleaseSummarizedView source
Removes last remnants of the YAML driver.
3.0.0GitHub ReleaseSummarizedView source
Removes deprecated handling of custom ObjectRepository implementations.
ObjectRepository
3.0.0GitHub ReleaseSummarizedView source
AUTO identity generation now defaults to IDENTITY instead of SEQUENCE for PostgreSQL.
Configuration::setIdentityGenerationPreferences()PostgreSQLPlatform::CLASSClassMetadata::GENERATOR_TYPE_SEQUENCE
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes partial objects, the PARTIAL DQL keyword, related hints and getPartialReference().
PARTIALDoctrine\ORM\Query\AST\PartialObjectExpressionDoctrine\ORM\Query\SqlWalker::HINT_PARTIALDoctrine\ORM\Query::HINT_FORCE_PARTIAL_LOADDoctrine\ORM\EntityManager*::getPartialReference()
3.0.0-beta1GitHub ReleaseSummarizedView source
ProxyFactory no longer extends doctrine/common's abstract factory and drops two methods.
Doctrine\ORM\Proxy\ProxyFactoryDoctrine\ORM\Proxy\ProxyFactory::createProxyDefinition()Doctrine\ORM\Proxy\ProxyFactory::resetUninitializedProxy()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the NOTIFY change tracking policy; use DEFERRED_EXPLICIT instead.
NOTIFYDEFERRED_EXPLICIT
3.0.0-beta1GitHub ReleaseSummarizedView source
Query::setDQL() no longer accepts null and Query::setFirstResult() no longer accepts null.
Doctrine\ORM\Query::setDQL()Doctrine\ORM\Query::setFirstResult()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the Doctrine\ORM\Proxy\Proxy interface; use Doctrine\Persistence\Proxy instead.
Doctrine\ORM\Proxy\ProxyDoctrine\Persistence\Proxy
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes getEntityManager() from OnClearEventArgs and flush event args; use getObjectManager().
Doctrine\ORM\Event\OnClearEventArgsDoctrine\ORM\Event\*FlushEventArgsgetEntityManager()getObjectManager()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the ClassMetadataInfo class; use ClassMetadata instead.
Doctrine\ORM\Mapping\ClassMetadataInfoDoctrine\ORM\Mapping\ClassMetadata
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the LifecycleEventArgs class; use the dedicated per-event argument classes instead.
Doctrine\ORM\Event\LifecycleEventArgsDoctrine\ORM\Event\PrePersistEventArgsDoctrine\ORM\Event\PreUpdateEventArgsDoctrine\ORM\Event\PreRemoveEventArgsDoctrine\ORM\Event\PostPersistEventArgsDoctrine\ORM\Event\PostUpdateEventArgsDoctrine\ORM\Event\PostRemoveEventArgsDoctrine\ORM\Event\PostLoadEventArgs
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes AttributeDriver::$entityAnnotationClasses and AttributeDriver::getReader().
AttributeDriver::$entityAnnotationClassesAttributeDriver::getReader()AttributeDriver::isTransient()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes InExpression; the parser now creates InListExpression or InSubselectExpression.
Doctrine\ORM\Query\AST\InExpressionInListExpressionInSubselectExpressionSqlWalker::walkInExpression()SqlWalker::walkInListExpression()SqlWalker::walkInSubselectExpression()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the AnnotationDriver and all annotation-related code; the Annotation maker interface is replaced by MappingAttribute.
AnnotationDriverDoctrine\ORM\Mapping\AnnotationDoctrine\ORM\Mapping\MappingAttribute
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes EntityManager::create(); the now-public constructor must be used instead and expects a Connection rather than a parameter array.
EntityManager::create()EntityManager::__construct()Doctrine\DBAL\DriverManager::getConnection()Connection
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the QueryBuilder constants SELECT, DELETE, UPDATE, STATE_DIRTY and STATE_CLEAN and the methods getState() and getType().
QueryBuilder::SELECTQueryBuilder::DELETEQueryBuilder::UPDATEQueryBuilder::STATE_DIRTYQueryBuilder::STATE_CLEANQueryBuilder::getState()QueryBuilder::getType()
3.0.0-beta1GitHub ReleaseSummarizedView source
Requires the alias argument when passing a class or type to QueryBuilder::update() and QueryBuilder::delete().
QueryBuilder::update()QueryBuilder::delete()
3.0.0-beta1GitHub ReleaseSummarizedView source
Splits output and tree walkers: SqlWalker no longer implements TreeWalker, and several walk methods are removed from TreeWalker, TreeWalkerAdapter and TreeWalkerChain.
SqlWalkerTreeWalkerTreeWalkerAdapterTreeWalkerChainsetQueryComponent()walkSelectClause()walkFromClause()walkJoin()
3.0.0-beta1GitHub ReleaseSummarizedView source
Splits output walkers and tree walkers, changing several TreeWalkerAdapter methods and removing _getQueryComponents().
walkLikeExpression()walkStateFieldPathExpression()walkComparisonExpression()walkInputParameter()walkArithmeticExpression()TreeWalkerAdapter::setQueryComponent()TreeWalkerAdapter::_getQueryComponents()TreeWalkerAdapter::getQueryComponents()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes identity column emulation through sequences; platforms without identity columns must use the SEQUENCE strategy.
SEQUENCE
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes StaticPHPDriver and DriverChain; use the equivalents from doctrine/persistence.
StaticPHPDriverDriverChainDoctrine\Persistence\Mapping\Driver\StaticPHPDriverDoctrine\Persistence\Mapping\Driver\MappingDriverChain
3.0.0-beta1GitHub ReleaseSummarizedView source
Drops the second argument to UnderscoreNamingStrategy::__construct(); the strategy is now always number aware.
UnderscoreNamingStrategy::__construct()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Proxy\Autoloader; use Doctrine\Common\Proxy\Autoloader instead.
Doctrine\ORM\Proxy\AutoloaderDoctrine\Common\Proxy\Autoloader
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Tools\DisconnectedClassMetadataFactory with no replacement.
Doctrine\ORM\Tools\DisconnectedClassMetadataFactory
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes support for Type::canRequireSQLConversion() and MappingException::sqlConversionNotAllowedForIdentifiers(); value conversion now always runs.
Type::canRequireSQLConversion()MappingException::sqlConversionNotAllowedForIdentifiers()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the doctrine binary and ConsoleRunner::printCliConfigTemplate(); bootstrap console tools manually per the docs.
ConsoleRunner::printCliConfigTemplate()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes EntityManagerHelper and HelperSetManagerProvider; console commands now require an $entityManagerProvider constructor argument.
Doctrine\ORM\Tools\Console\EntityManagerProvider\HelperSetManagerProviderDoctrine\ORM\Tools\Console\Helper\EntityManagerHelperDoctrine\ORM\Tools\Console\ConsoleRunner
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes EntityManagerHelper and related logic, changing createHelperSet(), run(), createApplication() and addCommands() signatures.
EntityManagerHelpercreateHelperSet()run()createApplication()addCommands()HelperSetEntityManagerProvider
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes entity namespace alias support from getRepository() and removes Configuration::addEntityNamespace() and getEntityNamespace().
EntityManager::getRepository()Configuration::addEntityNamespace()Configuration::getEntityNamespace()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the protected evictCollectionCache() and evictElementCache() methods from AbstractCollectionPersister.
Doctrine\ORM\Cache\Persister\Collection\AbstractCollectionPersisterevictCollectionCache()evictElementCache()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the TreeWalkerChainIterator class without replacement.
Doctrine\ORM\Query\TreeWalkerChainIterator
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes quoting methods from ClassMetadata since quoting is handled by QuoteStrategy implementations.
ClassMetadataDoctrine\ORM\Mapping\QuoteStrategygetQuotedIdentifierColumnNames()getQuotedColumnName()getQuotedTableName()getQuotedJoinTableName()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the ability to merge detached entities; UnitOfWork::merge() is removed and EntityManager::merge() throws.
UnitOfWork::merge()EntityManager::merge()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes partial flush/commit; flush() and commit() no longer accept entities and ignore the argument.
Doctrine\ORM\EntityManager::flush()Doctrine\ORM\Decorator\EntityManagerDecorator::flush()Doctrine\ORM\UnitOfWork::commit()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes partial clearing; EntityManager::clear() throws on non-null arguments and UnitOfWork::clear() always clears fully.
EntityManager::clear()UnitOfWork::clear()EntityRepository::clear()getEntityClass()clearsAllEntities()OnClearEventArgs
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine Cache support and the getQueryCacheImpl() and setQueryCacheImpl() methods from Configuration.
Doctrine\ORM\ConfigurationgetQueryCacheImpl()setQueryCacheImpl()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine Cache support from Configuration, replacing get/setHydrationCacheImpl() and get/setMetadataCacheImpl() with PSR-6 counterparts.
getHydrationCacheImpl()setHydrationCacheImpl()getMetadataCacheImpl()setMetadataCacheImpl()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Configuration::newDefaultAnnotationDriver(); use DoctrineSetup::createDefaultAnnotationDriver() instead.
Doctrine\ORM\Configuration::newDefaultAnnotationDriverDoctrine\ORM\Tools\DoctrineSetup::createDefaultAnnotationDriver()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Tools\Setup; use Doctrine\ORM\Tools\DoctrineSetup, which accepts a PSR-6 cache.
Doctrine\ORM\Tools\SetupDoctrine\ORM\Tools\DoctrineSetup
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes all APIs related to named queries.
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes old cache accessors and mutators from AbstractQuery and Query.
AbstractQuery::setResultCacheDriver()AbstractQuery::getResultCacheDriver()AbstractQuery::useResultCache()AbstractQuery::getResultCacheLifetime()AbstractQuery::getResultCacheId()Query::setQueryCacheDriver()Query::getQueryCacheDriver()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Cache\MultiGetRegion, merging the interface into Doctrine\ORM\Cache\Region.
Doctrine\ORM\Cache\MultiGetRegionDoctrine\ORM\Cache\Region
3.0.0-beta1GitHub ReleaseSummarizedView source
Renames AbstractIdGenerator::generate() to generateId() and removes generate().
AbstractIdGenerator::generate()AbstractIdGenerator::generateId()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes cache settings inspection: Configuration::ensureProductionSettings() and the orm:ensure-production-settings command.
Configuration::ensureProductionSettings()orm:ensure-production-settings
3.0.0-beta1GitHub ReleaseSummarizedView source
Reworks the second level cache to use PSR-6, changing DefaultCacheFactory and DefaultRegion and removing DefaultMultiGetRegion.
DefaultCacheFactoryDefaultMultiGetRegionDefaultRegionREGION_KEY_SEPARATORgetCacheEntryKey()getCache()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Mapping\Driver\PHPDriver; use StaticPHPDriver for programmatic metadata configuration.
Doctrine\ORM\Mapping\Driver\PHPDriverStaticPHPDriver
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes EntityManagerInterface::transactional(), replaced by wrapInTransaction().
Doctrine\ORM\EntityManagerInterface::transactional()Doctrine\ORM\EntityManagerInterface::wrapInTransaction()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Setup::registerAutoloadDirectory(); use Composer's autoloader instead.
Setup::registerAutoloadDirectory()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes YAML mapping drivers; migrate YamlDriver or SimpleYamlDriver to attribute or XML drivers.
YamlDriverSimpleYamlDriverorm:convert-mapping
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes the orm:generate:entities and orm:generate-repositories console commands and the Doctrine\ORM\Tools\Export namespace.
orm:generate:entitiesorm:generate-repositoriesDoctrine\ORM\Tools\ConvertDoctrine1SchemaDoctrine\ORM\Tools\EntityGeneratorDoctrine\ORM\Tools\EntityRepositoryGeneratorDoctrine\ORM\Tools\Export
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Version; use Composer's runtime API to check the ORM package version at runtime.
Doctrine\ORM\Version
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\ORMException and turns Doctrine\ORM\Exception\ORMException into an interface.
Doctrine\ORM\ORMExceptionDoctrine\ORM\Exception\ORMException
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\EntityManagerInterface#copy(), which never had an implementation.
Doctrine\ORM\EntityManagerInterface#copy()
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Id\TableGenerator and other classes related to UUID and TABLE generator strategies.
Doctrine\ORM\Id\TableGenerator
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes Doctrine\ORM\Id\UuidGenerator and the UUID identifier generation strategy.
Doctrine\ORM\Id\UuidGeneratorUUID
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes deprecated Query::iterate() along with AbstractHydrator::iterate(), AbstractHydrator::hydrateRow() and IterableResult.
Query::iterate()AbstractHydrator::iterate()AbstractHydrator::hydrateRow()IterableResulttoIterable()
3.0.0-beta1GitHub ReleaseSummarizedView source
Reverts the capability to use the allfields SQL notation.
3.4.1GitHub ReleaseSummarizedView source
Allows (Array)ParameterType in QueryBuilder, a backward compatibility break.
QueryBuilderArrayParameterTypeParameterType
3.0.1GitHub ReleaseSummarizedView source
Enforces native type declarations across the codebase.
3.0.0GitHub ReleaseSummarizedView source
Severs ties to the doctrine/common package.
3.0.0GitHub ReleaseSummarizedView source
Changes the EntityPersister return type.
EntityPersister
3.0.0GitHub ReleaseSummarizedView source
Uses lazy ghosts unconditionally.
3.0.0GitHub ReleaseSummarizedView source
Rejects ID collisions in the identity map unconditionally.
3.0.0GitHub ReleaseSummarizedView source
Updates the order of mapping attribute parameters.
3.0.0GitHub ReleaseSummarizedView source
Disallows lifecycle callbacks on embedded classes.
3.0.0GitHub ReleaseSummarizedView source
Turns a deprecation into an exception.
3.0.0GitHub ReleaseSummarizedView source
Enables XML validation unconditionally.
3.0.0GitHub ReleaseSummarizedView source
Cleans up backward compatibility layers.
3.0.0GitHub ReleaseSummarizedView source
Narrows down parameter types for quote strategies.
3.0.0GitHub ReleaseSummarizedView source
Throws on invalid one to one mappings.
3.0.0GitHub ReleaseSummarizedView source
Turns the deprecation from #10470 into an exception in 3.0.x.
3.0.0GitHub ReleaseSummarizedView source
Migrates the rest of the source code to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Migrates ClassMetadata to PHP 8 syntax.
ClassMetadata
3.0.0GitHub ReleaseSummarizedView source
Stops relying on underscores to indicate property visibility.
3.0.0GitHub ReleaseSummarizedView source
Migrates more classes to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Migrates the database driver to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Makes a missing inheritance declaration a failure.
3.0.0GitHub ReleaseSummarizedView source
Migrates ParserResult to PHP 8 syntax.
ParserResult
3.0.0GitHub ReleaseSummarizedView source
Migrates remaining exceptions to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Allows Lexer 3.
3.0.0GitHub ReleaseSummarizedView source
Modernizes QueryExpressionVisitor.
QueryExpressionVisitor
3.0.0GitHub ReleaseSummarizedView source
Adds a $lockMode parameter to EntityManager::refresh().
EntityManager::refresh()$lockMode
3.0.0GitHub ReleaseSummarizedView source
Adds native types to annotation classes.
3.0.0GitHub ReleaseSummarizedView source
Migrates collections to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Adds types to PersisterHelper.
PersisterHelper
3.0.0GitHub ReleaseSummarizedView source
Adds types to mapping builders.
3.0.0GitHub ReleaseSummarizedView source
Adds types to EntityListenerResolver.
EntityListenerResolver
3.0.0GitHub ReleaseSummarizedView source
Adds types to ProxyFactory.
ProxyFactory
3.0.0GitHub ReleaseSummarizedView source
Resolves QueryBuilder deprecations.
QueryBuilder
3.0.0GitHub ReleaseSummarizedView source
Shows Expr::countDistinct() and Expr::concat() use variable-length argument lists.
Expr::countDistinct()Expr::concat()
3.0.0GitHub ReleaseSummarizedView source
Migrates part of the tools namespace to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Migrates more code to PHP 8.
3.0.0GitHub ReleaseSummarizedView source
Stops allowing identity columns emulation.
3.0.0GitHub ReleaseSummarizedView source
Makes setter parameters mandatory.
3.0.0GitHub ReleaseSummarizedView source
Requires a new argument to joinColumnName().
joinColumnName()
3.0.0GitHub ReleaseSummarizedView source
Makes UnderscoreNamingStrategy number-aware only.
UnderscoreNamingStrategy
3.0.0GitHub ReleaseSummarizedView source
Adds native types to reflection property classes.
3.0.0GitHub ReleaseSummarizedView source
Splits TreeWalker and SqlWalker.
TreeWalkerSqlWalker
3.0.0GitHub ReleaseSummarizedView source
Adds native types to SQLFilter.
SQLFilter
3.0.0GitHub ReleaseSummarizedView source
Adds native types to EntityRepository.
EntityRepository
3.0.0GitHub ReleaseSummarizedView source
Adds native types to caches.
3.0.0GitHub ReleaseSummarizedView source
Adds native types to QueryBuilder.
QueryBuilder
3.0.0GitHub ReleaseSummarizedView source
Adds native types to persisters.
3.0.0GitHub ReleaseSummarizedView source
Adds more native types to entity manager implementations.
3.0.0GitHub ReleaseSummarizedView source
Adds native types to CacheLogger implementations.
CacheLogger
3.0.0GitHub ReleaseSummarizedView source
Adds native types to EntityHydrator.
EntityHydrator
3.0.0GitHub ReleaseSummarizedView source
Adds native types to console classes.
3.0.0GitHub ReleaseSummarizedView source
Adds native types to AbstractHydrator and child classes.
AbstractHydrator
3.0.0GitHub ReleaseSummarizedView source
Adds types to entity manager.
3.0.0GitHub ReleaseSummarizedView source
Stops using AbstractPlatform::canEmulateSchemas().
AbstractPlatform::canEmulateSchemas()
3.0.0GitHub ReleaseSummarizedView source
Fixes variadic args in Expr.
Expr
3.0.0GitHub ReleaseSummarizedView source
Inherits from homonym exception in parent package.
3.0.0GitHub ReleaseSummarizedView source
Removes schema visitors.
3.0.0GitHub ReleaseSummarizedView source
Extracts embedded class mapping into its own DTO.
3.0.0GitHub ReleaseSummarizedView source
Extracts discriminator column mapping into its own DTO.
3.0.0GitHub ReleaseSummarizedView source
Introduces a field mapping DTO.
3.0.0GitHub ReleaseSummarizedView source
Adds types to UnitOfWork.
UnitOfWork
3.0.0GitHub ReleaseSummarizedView source
Migrates persisters to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Migrates function nodes to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Adds types to Node::dispatch().
Node::dispatch()
3.0.0GitHub ReleaseSummarizedView source
Adds native types to QuoteStrategy classes.
3.0.0GitHub ReleaseSummarizedView source
Adds native types to ResultSetMapping.
ResultSetMapping
3.0.0GitHub ReleaseSummarizedView source
Fixes DBAL 4 compatibility.
3.0.0GitHub ReleaseSummarizedView source
Migrates classes with the fewest changes.
3.0.0GitHub ReleaseSummarizedView source
Migrates classes with the fewest changes to PHP 8.
3.0.0GitHub ReleaseSummarizedView source
Migrates Expr and Lexer to PHP 8 syntax.
ExprLexer
3.0.0GitHub ReleaseSummarizedView source
Migrates AST namespace to PHP 8 syntax.
3.0.0GitHub ReleaseSummarizedView source
Purges annotations.
3.0.0GitHub ReleaseSummarizedView source
Migrates to attributes.
3.0.0GitHub ReleaseSummarizedView source
Migrates Configuration to PHP 8 syntax.
Configuration
3.0.0GitHub ReleaseSummarizedView source
Migrates AbstractQuery and child classes to PHP 8.
AbstractQuery
3.0.0GitHub ReleaseSummarizedView source
Refactors ORMException into an interface.
ORMException
3.0.0GitHub ReleaseSummarizedView source
Uses native type declarations for naming strategies.
3.0.0GitHub ReleaseSummarizedView source
Migrates to the object API of JoinColumnMapping and JoinTableMapping.
JoinColumnMappingJoinTableMapping
3.0.0GitHub ReleaseSummarizedView source
Makes the join table name and join column name mandatory.
3.0.0GitHub ReleaseSummarizedView source
Migrates to the object API of AssociationMapping.
AssociationMapping
3.0.0GitHub ReleaseSummarizedView source
Reworks the association mapping hierarchy.
3.0.0GitHub ReleaseSummarizedView source
Migrates to the embedded class mapping object API.
3.0.0GitHub ReleaseSummarizedView source
Migrates to DiscriminatorColumnMapping's object API.
DiscriminatorColumnMapping
3.0.0GitHub ReleaseSummarizedView source
Uses Rector to migrate to the object API of FieldMapping.
FieldMapping
3.0.0GitHub ReleaseSummarizedView source
Extracts AssociationMapping into its own DTO.
AssociationMapping
3.0.0GitHub ReleaseSummarizedView source
Illegal attributes on embeddables now throw an exception instead of being ignored.
#[Column]#[Embedded]
3.0.0-beta1GitHub ReleaseSummarizedView source
EntityPersister::executeInserts() now returns void instead of an array of insert IDs.
Doctrine\ORM\Persister\Entity\EntityPersister::executeInserts()UnitOfWork::assignPostInsertId()
3.0.0-beta1GitHub ReleaseSummarizedView source
Lazy ghosts are always enabled; setLazyGhostObjectEnabled() and isLazyGhostObjectEnabled() are no-ops.
Doctrine\ORM\Configuration::setLazyGhostObjectEnabled()Doctrine\ORM\Configuration::isLazyGhostObjectEnabled()
3.0.0-beta1GitHub ReleaseSummarizedView source
Identity map collisions are always rejected; the related configuration methods are no-ops.
Doctrine\ORM\Configuration::setRejectIdCollisionInIdentityMap()Doctrine\ORM\Configuration::isRejectIdCollisionInIdentityMapEnabled()
3.0.0-beta1GitHub ReleaseSummarizedView source
Lifecycle callback mapping on embedded classes is now explicitly forbidden.
3.0.0-beta1GitHub ReleaseSummarizedView source
XmlDriver constructor's third argument is now a no-op because XML validation is always enabled.
Doctrine\ORM\Mapping\Driver\XmlDriver::__construct()Doctrine\ORM\Mapping\Driver\SimplifiedXmlDriverDoctrine\ORM\ORMSetup::createXMLMetadataConfiguration()
3.0.0-beta1GitHub ReleaseSummarizedView source
AttributeDriver constructor's second argument is now a no-op because the new behavior is always enforced.
Doctrine\ORM\Mapping\Driver\AttributeDriver::__construct()
3.0.0-beta1GitHub ReleaseSummarizedView source
Overriding fields or associations inherited from parent entity classes now throws a MappingException.
MappingException
3.0.0-beta1GitHub ReleaseSummarizedView source
Undeclared entity inheritance now throws a MappingException.
MappingException
3.0.0-beta1GitHub ReleaseSummarizedView source
Changes the refresh() signatures on EntityManagerInterface, EntityManagerDecorator and UnitOfWork to add an optional LockMode|int|null $lockMode parameter defaulting to null.
EntityManagerInterface::refresh()EntityManagerDecorator::refresh()UnitOfWork::refresh()LockMode
3.0.0-beta1GitHub ReleaseSummarizedView source
Splits output walkers and tree walkers, changing the walker method set.
walkSimpleSelectExpression()walkAggregateExpression()walkGroupByClause()walkGroupByItem()walkDeleteClause()walkUpdateClause()walkUpdateItem()walkWhereClause()
3.0.0-beta1GitHub ReleaseSummarizedView source
Adds walker methods for conditional expressions, exists, collection, null, in, instanceof, literal and between nodes.
walkConditionalExpression()walkConditionalTerm()walkConditionalFactor()walkConditionalPrimary()walkExistsExpression()walkCollectionMemberExpression()walkEmptyCollectionComparisonExpression()walkNullComparisonExpression()
3.0.0-beta1GitHub ReleaseSummarizedView source
Makes setter parameters mandatory in OnClassMetadataNotFoundEventArgs and AbstractQuery cache setters; pass null instead of omitting.
Doctrine\ORM\Event\OnClassMetadataNotFoundEventArgs::setFoundMetadata()Doctrine\ORM\AbstractQuery::setHydrationCacheProfile()Doctrine\ORM\AbstractQuery::setResultCache()Doctrine\ORM\AbstractQuery::setResultCacheProfile()
3.0.0-beta1GitHub ReleaseSummarizedView source
Adds a $className argument to NamingStrategy::joinColumnName().
NamingStrategy::joinColumnName()
3.0.0-beta1GitHub ReleaseSummarizedView source
Turns Exception\ORMException into an interface and moves all its factory methods to dedicated exception classes.
Doctrine\ORM\ORMExceptionMissingMappingDriverImplementation::create()UnrecognizedField::byName()UnexpectedAssociationValue::create()InvalidOrientation::fromClassNameAndField()EntityManagerClosed::create()InvalidHydrationMode::fromMode()MismatchedEventManager::create()
3.0.0-beta1GitHub ReleaseSummarizedView source
Turns Cache\CacheException into an interface and moves its factory methods to dedicated cache exception classes.
Doctrine\ORM\Cache\CacheExceptionCannotUpdateReadOnlyCollection::fromEntityAndField()CannotUpdateReadOnlyEntity::fromEntity()NonCacheableEntity::fromEntity()NonCacheableEntityAssociation::fromEntityAndField()
3.0.0-beta1GitHub ReleaseSummarizedView source
Requires custom repository classes to extend EntityRepository, adding a missing type declaration for identifier generators.
ObjectRepositoryEntityRepository
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes support for schema emulation; the ORM no longer emulates schemas on SQLite.
3.0.0-beta1GitHub ReleaseSummarizedView source
Removes code generators and the orm:convert-d1-schema and orm:convert-mapping console commands.
orm:convert-d1-schemaorm:convert-mapping
3.0.0-beta1GitHub ReleaseSummarizedView source
Makes the $criteria argument of Doctrine\ORM\EntityRepository::count() optional; child class overrides must be made compatible.
Doctrine\ORM\EntityRepository::count()$criteria
3.0.0-beta1GitHub ReleaseSummarizedView source
Replaces func_get_args() simulation with native variadics in Expr and QueryBuilder methods; overridden signatures must change.
Doctrine\ORM\Query\Expr#andX()Doctrine\ORM\Query\Expr#orX()Doctrine\ORM\QueryBuilder#select()Doctrine\ORM\QueryBuilder#addSelect()Doctrine\ORM\QueryBuilder#where()Doctrine\ORM\QueryBuilder#andWhere()Doctrine\ORM\QueryBuilder#orWhere()Doctrine\ORM\QueryBuilder#groupBy()
3.0.0-beta1GitHub ReleaseSummarizedView source
Migrates Internal namespace to PHP 8.
3.0.0GitHub ReleaseSummarizedView source
Migrates Tools/Schema* to PHP 8.0.
3.0.0GitHub ReleaseSummarizedView source
The orm:schema-tool:update --complete option is now a no-op since complete mode is always used.
orm:schema-tool:update--complete
3.0.0-beta1GitHub ReleaseSummarizedView source
Security1
Hardens CursorPaginator against security concerns.
CursorPaginator
3.7.0GitHub ReleaseSummarizedView source
Platform3
Requires PHP 8.1.
3.0.0GitHub ReleaseSummarizedView source
Drops support for PHP 7.4.
3.0.0GitHub ReleaseSummarizedView source
Bumps the required PHP version to 7.4.
3.0.0GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated29
Introduces PaginatorInterface::HINT_ENABLE_DISTINCT and uses OffsetPaginator in tests.
PaginatorInterface::HINT_ENABLE_DISTINCTOffsetPaginator
3.7.0GitHub ReleaseSummarizedView source
Deprecates JoinColumns.
JoinColumns
3.7.0GitHub ReleaseSummarizedView source
Makes LockMode::NONE a no-op.
LockMode::NONE
3.7.0GitHub ReleaseSummarizedView source
Deprecates TypedExpression in favor of ExpressionWithReturnType.
TypedExpressionExpressionWithReturnType
3.7.0GitHub ReleaseSummarizedView source
Allows usage of SortDirection with attribute and PHP drivers.
SortDirection
3.7.0GitHub ReleaseSummarizedView source
Allows SortDirection usage inside OrderBy and QueryBuilder.
SortDirectionOrderByQueryBuilder
3.7.0GitHub ReleaseSummarizedView source
Leverages event manager interfaces.
3.7.0GitHub ReleaseSummarizedView source
Deprecates string default expressions.
3.6.0GitHub ReleaseSummarizedView source
Deprecates FieldMapping::$default.
FieldMapping::$default
3.6.0GitHub ReleaseSummarizedView source
Deprecates specifying nullable on primary key columns.
3.6.0GitHub ReleaseSummarizedView source
Stops using QueryBuilder::getRootAlias().
QueryBuilder::getRootAlias()
3.6.0GitHub ReleaseSummarizedView source
Adds deprecation messages for methods that were only annotated as being @deprecated.
3.6.0GitHub ReleaseSummarizedView source
Addresses the deprecation of default expressions.
3.5.4GitHub ReleaseSummarizedView source
Deprecates ClassMetadata::$reflFields.
ClassMetadata::$reflFields
3.5.1GitHub ReleaseSummarizedView source
Deprecates the proxy autoloader and class name resolver.
3.5.0GitHub ReleaseSummarizedView source
Provides an upgrade path to the new ORMSetup::create* signature.
ORMSetup::create*
3.5.0GitHub ReleaseSummarizedView source
Deprecates more proxies-related methods or calls.
3.5.0GitHub ReleaseSummarizedView source
Deprecates not using native lazy objects on PHP 8.4+.
3.5.0GitHub ReleaseSummarizedView source
Deprecates methods for configuring no longer configurable features.
3.5.0GitHub ReleaseSummarizedView source
Deprecates passing the same class with different discriminator values.
3.3.1GitHub ReleaseSummarizedView source
Deprecates DatabaseDriver.
DatabaseDriver
3.3.0GitHub ReleaseSummarizedView source
Deprecates the NotSupported exception.
NotSupported
3.2.0GitHub ReleaseSummarizedView source
Deprecates SequenceGenerator implementing Serializable.
SequenceGeneratorSerializable
3.2.0GitHub ReleaseSummarizedView source
Deprecates obsolete and unnecessary properties from the Table attribute.
Table
3.2.0GitHub ReleaseSummarizedView source
Deprecates the --complete option of orm:schema-tool:update.
orm:schema-tool:update--complete
3.2.0GitHub ReleaseSummarizedView source
Uses EnumReflectionProperty class from the persistence package.
EnumReflectionProperty
3.1.0GitHub ReleaseSummarizedView source
Translates a comment into code and annotations.
3.1.0GitHub ReleaseSummarizedView source
Deprecates array access.
3.1.0GitHub ReleaseSummarizedView source
Deprecates annotation classes for named queries.
3.0.0-beta2GitHub ReleaseSummarizedView source