2.8.0

Release Notes for 2.8.0

2.8.0

• Total issues resolved: 6

• Total pull requests resolved: 10

• Total contributors: 13

• 8332: Upgrade Psalm to v4.1.1 thanks to @beberlei

• 8291: Validate Embeddable associations in SchemaValidator thanks to @kejwmen

• 8137: Deprecation notices from doctrine/inflector 1.4 thanks to @W0rma

• 7885: Introduce getIterable() on AbstractQuery thanks to @simPod

New Feature

• 8140: add possibility to use sql comments in the DQL syntax thanks to @philippe-levan

Documentation

• 8130: Improve CLI config documentation thanks to @gbirke

Hacktoberfest,Improvement

• 8069: Convert PHPUnit @expectedException into method call thanks to @beberlei

Deprecation

• 7955: EntityManagerInterface extends deprecated Doctrine\Common\Persistence\ObjectManager thanks to @vanoostrum
• 7928: Deprecate EntityRepository#clear() thanks to @kokspflanze and @lcobucci

CI,Improvement

• 7948: Add stage that runs before Test to allow fast failures on Sqlite/phpcs thanks to @beberlei

Requires merge/review

• 7946: Throw OptimisticLockException when connection::commit() returns false thanks to @chosroes

Improvement

• 7941: Allow DQL functions to specify return type thanks to @Grafikart

2.7.5

Release Notes for 2.7.5

2.7.5

• Total issues resolved: 0

• Total pull requests resolved: 2

• Total contributors: 2

• 8348: [GH-8229] Prevent Illegal Inheritance Override thanks to @beberlei

• 8329: Fix SQL alias generation regression for simple inheritance thanks to @rogregoire

2.7.4

Release Notes for 2.7.4

2.7.4

• Total issues resolved: 0

• Total pull requests resolved: 8

• Total contributors: 8

• 8286: psalm fixes thanks to @orklah

• 8150: Infer return type information with Psalter thanks to @greg0ire

• 8107: Fix QueryBuilder::getParameter() on parameter names with colons thanks to @tom93

Bug

• 8277: Fix OrderByItem parser to proceed with SimpleArithmetic expression before function thanks to @ipernet
• 8234: Fix for bug #8229 (id column from parent class renamed in child class) thanks to @cziegenberg
• 8122: Prohibits class typo in the discriminator map thanks to @gquemener

Documentation

• 8223: Change preferred cache driver for metadata and query caches thanks to @bcremer
• 8109: Add alert to "avoid persisting detached entities" thanks to @Pictor13

v2.7.3

2.7.3

• Total issues resolved: 1

• Total pull requests resolved: 5

• Total contributors: 4

• 8158: Allow doctrine/common 3 and doctrine/persistence 2 thanks to @greg0ire

• 8062: Convert PHP to SQL for new object expression thanks to @jeroenvdheuvel

• 7989: Fix issues detected by psalm on 2.7 thanks to @orklah

BC Break,Bug

• 8138: Revert changes to embeddable mapping in 2.7 thanks to @beberlei

Deprecation,Improvement

• 7953: Address deprecations from persistence thanks to @greg0ire

2.7.2

2.7.2

• Total issues resolved: 4
• Total pull requests resolved: 5
• Total contributors: 8

Documentation

• 8041: Improve documentation about naming strategy usage thanks to @RosemaryOrchard

Bug

• 8031: Undefined alias for Embeddable in 2.7.1 thanks to @vicdelfant
• 8030: Problem with Proxies on PHP 7.4.2 with typed properties thanks to @bizley
• 8023: Put into cache using root entity name thanks to @peterkeatingie
• 7969: Child entity not retrieved from array cache thanks to @peterkeatingie
• 8055: Fix regression in 2.7.1 when mysqli is used with discriminator column that is not a string thanks to @mpdude
• 8050: [GH-7633] disallow cache partial objects thanks to @beberlei
• 8036: Fix inherited embeddables and nesting after AnnotationDriver change #8006 thanks to @malarzm
• 7633: Partial objects get cached and break "actual" objects thanks to @Amunak

2.7.1

A notable change of this version is the introduction of ocramius/package-versions to provide version information, most importantly when using the Doctrine CLI. That also means that you cannot rely on Doctrine\ORM\Version::VERSION constant anymore going forward it will always point to 2.7.1-DEV.

When you update, also make sure to include an update to doctrine/persistence version 1.3.6 and doctrine/reflection 1.1

2.7.1

• Total issues resolved: 4
• Total pull requests resolved: 11
• Total contributors: 11

Bug

• 8006: Make Embeddable not transient thanks to @malarzm
• 7987: [GH-7982] no sql executor leads to parse error thanks to @beberlei
• 7983: Null offset access in DQL parser thanks to @ntzm
• 7974: [GH-7505] Bug in SimpleObjectHydrator when using inheritance with same field thanks to @beberlei and @m-r-r
• 7940: [GH-7864] Bugfix in PersistentCollection::removeElement for EXTRA_LAZY. thanks to @beberlei
• 7934: Fix Trying to access array offset on value of type null thanks to @BenMorel
• 7957: Fix version information thanks to @lcobucci

Documentation

• 7973: Just a micro grammar update. thanks to @DocFX
• 7619: Update improving-performance.rst to reflect current state of PHP ecosystem thanks to @Majkl578
• 7500: Prefer PhpFileCache for caching docs thanks to @shadowhand

CI,Deprecation

• 7956: Ignore Doctrine\Common\Persistence\ObjectManagerDecorator deprecation thanks to @lcobucci

Bug,Regression

• 7937: Revert SchemaTool change to check for foreign key support thanks to @beberlei and @fmathieu1

BC Break,Bug

• 7875: Whilelist existing assets we know about from metadata in SchemaTool::getUpdateSchemaSql() thanks to @nicolas-grekas

v2.7.0

This release solves Symfony 5.0 compatibility issues, some small improvements, and adds various deprecation notices.

Please read carefully the upgrade to 2.7 notes to know more about the reasons and how to fix the deprecation messages.

---

• Total issues resolved: 1
• Total pull requests resolved: 15
• Total contributors: 10

Deprecation

• 7911: Be explicit about which Doctrine package in message thanks to @lcobucci
• 7909: Add deprecation messages thanks to @lcobucci
• 7901: Add deprecation warnings for 2.7.x thanks to @lcobucci
• 7701: Split and deprecate AbstractQuery#useResultCache() thanks to @someniatko

CI

• 7904: Make sure composer files are valid thanks to @greg0ire
• 7600: [2.7] CI: Test against PHP 7.4snapshot instead of nightly (8.0) thanks to @Majkl578

Improvement

• 7876: Fix compat of commands with Symfony 5 thanks to @nicolas-grekas
• 7829: Skip Paginator LIMIT subquery and WHERE IN if query do not have LIMIT thanks to @Seb33300
• 7723: Allow Symfony 5.0 thanks to @nicolas-grekas
• 7710: Prettified arrays in tool command orm:mapping:describe thanks to @rtek
• 7340: Fix config template for PHPUnit >= 7.2 thanks to @guilliamxavier

BC Break,Improvement

• 7863: Paginator: Skip limit subquery if not required thanks to @Seb33300

Documentation

• 7382: Update homepage thanks to @Majkl578

Bug

• 7326: Cherry-pick #7307 to fix remaining usages of deprecated ClassLoader and Inflector from doctrine/common thanks to @nicolas-grekas
• 7079: Fix getJoinTableName for sqlite with schema attribute thanks to @mairo744

BC Break,Deprecation,Improvement

• 6803: Deprecation of EntityManager copy method thanks to @SenseException

v2.6.6

This release solves the violation of our BC guarantees, we apologise for impacting existing software.

---

• Total issues resolved: 0
• Total pull requests resolved: 1
• Total contributors: 1

BC Break,Bug

• 7908: Fix BC-break on underscore naming strategy thanks to @lcobucci

v2.6.5

This release fixes some important bugs (including a few regressions related to the paginator component and cleaning collections when using DEFERRED_EXPLICIT).

It also marks the EOL for the v2.6.x series since we'll soon be releasing v2.7.0.

---

• Total issues resolved: 9
• Total pull requests resolved: 23
• Total contributors: 24

Bug,Regression

• 7905: [Paginator] Fix type conversion during hydration of pagination limit subquery thanks to @akorz, @lcobucci, and @ostrolucky
• 7862: Using ArrayCollection->clear over an entity marked to be persisted, doesn't create corresponding DELETE statements thanks to @ferrastas and @ostrolucky
• 7861: Delete statements will not be created using clear thanks to @ferrastas

Bug

• 7869: UnitOfWork::clear() misses $eagerLoadingEntities thanks to @BenMorel
• 7865: #7837 paginate with custom identifier types even with enabled DQL query cache thanks to @Ocramius
• 7856: Fix underscore naming strategy behaviour with numbers thanks to @lcobucci
• 7855: Numbers in a string using underscore naming strategy thanks to @vuras
• 7850: Don't merge PersistentCollection orderBy with criteria in matching() thanks to @nlx-lars
• 7842: #7841 SchemaTool generates extra diff for platforms without FK support thanks to @vpArth
• 7764: #7763 escape quotes in field comments thanks to @guillaume-a
• 7763: "doctrine:mapping:import" does not escape quotes in field comments thanks to @guillaume-a
• 7684: only replace '_id' at end of columnName thanks to @rharink

CI

• 7889: Use quoted collation declaration when available, fixes test suite when running against DBAL 2.10+ thanks to @ajgarlag

Documentation

• 7884: [Documentation] Advanced field value... - missing entity alias thanks to @rogeriolino
• 7880: Update documentation to recommend DQL over QueryBuilder when possible thanks to @kuraobi and @javiereguiluz
• 7871: AbstractQuery::getSingleScalarResult() throws exception when no result thanks to @BenMorel
• 7858: Invalid version in Doctrine\ORM\Version::VERSION thanks to @guillaumesmo
• 7849: Mention SQL logger impact on batch processing thanks to @axi
• 7838: Fix the name of ClassMetadata in documentation thanks to @samnela
• 7768: Fix EntityManagerHelper's documentation (it can't accept an array of paths) thanks to @mickaelandrieu
• 7727: [doc] Finish incomplete definition of class UTCDateTimeType thanks to @madand
• 7671: Added missing "the" thanks to @jschaedl
• 7667: Fixes example One-To-One, Self-referencing thanks to @jschaedl
• 7443: Added doc about exception in Query#getOneOrNullResult() thanks to @Naitsirch and @Mynyx
• 7298: Add a missing type in Query::getFirstResult PHPDoc thanks to @dunglas

Improvement

• 7851: Remove not used variable $reflFieldValue in ObjectHydrator thanks to @peter-gribanov

v2.6.4

This release fixes many bugs (including a performance regression) and makes the v2.x series compatible with PHP 7.4.

---

• Total issues resolved: 11
• Total pull requests resolved: 32
• Total contributors: 30

Improvement

• 7785: Fix "access array offset on value of type null" PHP 7.4 notices thanks to @mlocati
• 7142: Rename this repository to doctrine/orm thanks to @greg0ire

Bug

• 7821: Bug: #7820 paginator ignores dbal type conversions in identifiers thanks to @Ocramius
• 7778: Guard L2C regions against corrupted data thanks to @umpirsky
• 7767: PersistentCollection::matching() does not respect the collections native sorting thanks to @stephanschuler
• 7766: Respect collection orderBy meta when matching() thanks to @stephanschuler
• 7761: Do not modify UOW on PersistentCollection::clear() when owner has DEFFERED_EXPLICIT change tracking policy thanks to @paxal
• 7750: Fix incorrect return of null values in L2C thanks to @AlexSmerw
• 7737: Fix MEMBER_OF comparison when using criteria in query builder thanks to @Smartel1
• 7735: Null in fields value in Cached Entity several times on day on high-load project. thanks to @AlexSmerw
• 7630: Fix #7629 - scheduledForSynchronization leaks memory when using @ORM\ChangeTrackingPolicy("DEFERRED_EXPLICIT") thanks to @yethee
• 7528: Prevent UnitOfWork lookup for DBAL types specified in Doctrine\ORM\Query#setParameter() thanks to @Ocramius
• 7322: JoinedSubclassPersister pass identifier types on delete thanks to @dennisenderink and @fred-jan
• 7266: Call to a member function resolveAssociationEntries() on boolean {"detail":"[object] (Symfony\Component\Debug\Exception\FatalThrowableError(code: 0): Call to a member function resolveAssociationEntries() on boolean at /www/vendor/doctrine/orm/lib/Doctrine/ORM/Cache/DefaultQueryCache.php:140)"} thanks to @mingmingxianseng
• 4632: DDC-3789: Paginator does not convert entity ids if they are value objects thanks to @doctrinebot

Documentation

• 7818: Add note into docs about not using SimpleAnnotationReader thanks to @SenseException
• 7791: Fix preFlush event documentation stating incorrectly that flush can be called safely thanks to @Steveb-p
• 7753: Add ORM annotations in getting-started docs thanks to @SenseException and @wajdijurry
• 7744: Fixed a typo-error thanks to @noobshow
• 7732: [Documentation] Missing comma fix thanks to @lchrusciel
• 7729: Update DATE_ADD and DATE_SUB docs thanks to @JoppeDC
• 7672: Added cross-links to relevant documentation thanks to @jschaedl
• 7612: Update ordered-associations.rst thanks to @spirlici
• 7610: Change APC to OPcache in improving-performance.rst thanks to @smtchahal
• 7596: Correct method names and broken link in docs thanks to @mbessolov
• 7577: Fix of single link to dbal docs in advanced-configuration.rst thanks to @SenseException
• 7572: Remove codeigniter Framework example thanks to @SenseException
• 7571: Fix typo in inheritance mappings docs thanks to @batwolf
• 7557: Change Stackoverflow tag to doctrine-orm thanks to @malarzm
• 7551: [2.6] Migrate repository name doctrine/doctrine2 -> doctrine/orm thanks to @Majkl578
• 7530: Documentation error typo fix: s/Used-defined/User-Defined thanks to @vladyslavstartsev
• 7519: #7518 Fixed type mismatch between EntityRepository#__construct() and its documented constructor arguments thanks to @koftikes
• 7518: EntityRepository::__construct() expects Doctrine\ORM\EntityManager instead of actual required EntityManagerInterface thanks to @koftikes
• 7490: Fix broken link thanks to @vladyslavstartsev
• 7483: Fixed a minor syntax issue thanks to @javiereguiluz

CI

• 7794: Fix test compatibility with DBAL 2.10.x-dev thanks to @lcobucci
• 7731: Replace custom install script with add-on thanks to @greg0ire
• 7473: Incremental CS checks in 2.x branches thanks to @Majkl578