### Release Notes for [2.12.1](https://github.com/doctrine/orm/milest…

…one/109)

2.12.x bugfix release (patch)

### 2.12.1

- Total issues resolved: **0**
- Total pull requests resolved: **1**
- Total contributors: **1**

#### Bug

 - [9671: Conditionally extend the old `AnnotationDriver` class](doctrine#9671) thanks to @derrabus

### Release Notes for [2.12.0](https://github.com/doctrine/orm/milest…

…one/106)

Feature release (minor)

### 2.12.0

- Total issues resolved: **1**
- Total pull requests resolved: **52**
- Total contributors: **8**

#### Deprecation,Documentation

 - [9661: Deprecate the doctrine binary](doctrine#9661) thanks to @derrabus

#### Test Suite

 - [9658: Fix IdentifierFlattenerEnumIdTest](doctrine#9658) thanks to @michnovka
 - [9649: Fix test file/class names](doctrine#9649) thanks to @michnovka
 - [9612: Skip tests requiring ObjectManagerAware](doctrine#9612) thanks to @derrabus
 - [9489: Avoid calling `merge()`](doctrine#9489) thanks to @derrabus
 - [9479: Remove useless catches](doctrine#9479) thanks to @derrabus
 - [9472: Skip tests related to PersistentObject if that class is missing](doctrine#9472) thanks to @derrabus
 - [9451: Streamline cache creation in tests](doctrine#9451) thanks to @derrabus
 - [9423: Introduce `assertQueryCount()`](doctrine#9423) thanks to @derrabus
 - [9418: Switch tests to the middleware logging system](doctrine#9418) thanks to @derrabus
 - [9404: Rework some tests that use hardcoded DBAL mocks](doctrine#9404) thanks to @morozov

#### Bug

 - [9657: Fix enum hydration when fetching partial results](doctrine#9657) thanks to @michnovka
 - [9580: Check if association already contains object ](doctrine#9580) thanks to @klammbueddel
 - [9459: Check requirements for metadata drivers](doctrine#9459) thanks to @derrabus

 - [9656: Indicate support for `doctrine/persistence` 3](doctrine#9656) thanks to @derrabus

#### Deprecation,Improvement

 - [9646: Improve exception message](doctrine#9646) thanks to @greg0ire
 - [9511: Replace `TreeWalkerChainIterator` with a generator](doctrine#9511) thanks to @derrabus
 - [9443: Introduce `DoctrineSetup` as a replacement for `Setup`](doctrine#9443) thanks to @derrabus

#### Deprecation

 - [9641: Deprecate console helper](doctrine#9641) thanks to @derrabus
 - [9592: Deprecate or throw on namespace alias usage](doctrine#9592) thanks to @greg0ire
 - [9533: Deprecate custom `ObjectRepository` implementations](doctrine#9533) thanks to @derrabus
 - [9532: Un-deprecate the current proxy mechanism](doctrine#9532) thanks to @derrabus
 - [9512: Document deprecation of `AbstractCollectionPersister` helpers](doctrine#9512) thanks to @derrabus
 - [9475: Deprecate methods removed in 3.0](doctrine#9475) thanks to @derrabus
 - [9397: Deprecate MultiGetRegion](doctrine#9397) thanks to @derrabus

#### Static Analysis

 - [9633: Leverage generic persistence event classes](doctrine#9633) thanks to @derrabus
 - [9621: Fix types on ResultSetMapping](doctrine#9621) thanks to @derrabus
 - [9603: Implement int-mask-of where appropriate](doctrine#9603) thanks to @greg0ire
 - [9566: Fix types on `walkLiteral()` and `walkLikeExpression()`](doctrine#9566) thanks to @derrabus
 - [9565: Fix type on `SqlWalker::walkPathExpression()`](doctrine#9565) thanks to @derrabus
 - [9553: Document tree walker class strings](doctrine#9553) thanks to @derrabus
 - [9552: Use literal types for `JOIN&doctrine#95;TYPE&doctrine#95;*` constants](doctrine#9552) thanks to @derrabus
 - [9549: Leverage Lexer's Token type](doctrine#9549) thanks to @derrabus
 - [9541: Improve templating](doctrine#9541) thanks to @greg0ire
 - [9527: Document QueryComponent array shape](doctrine#9527) thanks to @derrabus
 - [9525: Fix more types on EntityRepository and FilterCollection](doctrine#9525) thanks to @derrabus
 - [9492: Fix types on QueryBuilder](doctrine#9492) thanks to @derrabus
 - [9474: Fix types on EntityRepository](doctrine#9474) thanks to @derrabus
 - [9401: Fix types on CacheLogger implementations](doctrine#9401) thanks to @derrabus

#### New Feature

 - [9629: Support Enum IDs and search by Enum fields](doctrine#9629) thanks to @michnovka
 - [9616: Support enums as default values](doctrine#9616) thanks to @derrabus and @jgroc-de
 - [9497: Add support for array of enums](doctrine#9497) thanks to @dreadnip
 - [9373: Support enum cases as parameters](doctrine#9373) thanks to @derrabus

#### Improvement

 - [9587: Implement colocated mapping driver](doctrine#9587) thanks to @greg0ire
 - [9578: Leverage `MemcachedAdapter::isSupported()`](doctrine#9578) thanks to @derrabus
 - [9481: Rename `DoctrineSetup` to `ORMSetup`](doctrine#9481) thanks to @derrabus
 - [9480: Modernize `strpos()` calls](doctrine#9480) thanks to @derrabus
 - [9453: Support enums in findBy() calls](doctrine#9453) thanks to @derrabus
 - [9019: validate schema command: allow to debug missing schema updates list](doctrine#9019) thanks to @COil

#### Deprecation,Static Analysis

 - [9507: Fix types on caches](doctrine#9507) thanks to @derrabus

#### Deprecation,Static Analysis,Test Suite

 - [9466: Fix types on persisters](doctrine#9466) thanks to @derrabus

#### Documentation

 - [9448: Document the new `DoctrineSetup` class](doctrine#9448) thanks to @derrabus

### Release Notes for [2.11.3](https://github.com/doctrine/orm/milest…

…one/108)

2.11.x bugfix release (patch)

### 2.11.3

- Total issues resolved: **0**
- Total pull requests resolved: **10**
- Total contributors: **6**

#### Bug

 - [9663: ScalarColumnHydrator: prevent early-bail on falsy values](doctrine#9663) thanks to @MrMitch
 - [9623: explicitly use the non-deprecated ORMException](doctrine#9623) thanks to @BenoitDuffez
 - [9589: Fix type errors with XML export on PHP 8.1](doctrine#9589) thanks to @vrestihnat

#### Static Analysis

 - [9648: Fix static analysis for Persistence 2.5](doctrine#9648) thanks to @derrabus
 - [9607: PHPStan 1.5.0](doctrine#9607) thanks to @derrabus
 - [9590: Ignore deprecation from Persistence](doctrine#9590) thanks to @greg0ire
 - [9577: Baseline Psalm errors caused by DBAL 3.3.3](doctrine#9577) thanks to @derrabus

#### Documentation

 - [9639: Fix composer install in contributing readme](doctrine#9639) thanks to @ruudk
 - [9611: Remove "Description of" PHPDoc](doctrine#9611) thanks to @derrabus
 - [9598: Use correct syntax for external links](doctrine#9598) thanks to @greg0ire

### Release Notes for [2.11.2](https://github.com/doctrine/orm/milest…

…one/107)

2.11.x bugfix release (patch)

### 2.11.2

- Total issues resolved: **0**
- Total pull requests resolved: **21**
- Total contributors: **12**

#### Bug

 - [9574: Make sure MemcachedAdapter is supported before tring to use it](doctrine#9574) thanks to @flack
 - [9537: Make error message suggestion accurate](doctrine#9537) thanks to @kiler129
 - [9523: Bring `FilterCollection` to a "clean" state after hash computation](doctrine#9523) thanks to @mpdude
 - [9457: PDO is not a required extension](doctrine#9457) thanks to @derrabus
 - [9452: Check requirements for metadata drivers](doctrine#9452) thanks to @derrabus

#### Documentation

 - [9569: Fixing `:doc:` link](doctrine#9569) thanks to @ThomasLandauer
 - [9563: Remove reference to removed class](doctrine#9563) thanks to @greg0ire
 - [9555: Adding PHP attributes](doctrine#9555) thanks to @ThomasLandauer
 - [9513: Fix syntax typo in attributes reference in documentation](doctrine#9513) thanks to @einenlum
 - [9487: Fix `#&doctrine#91;DiscriminatorMap&doctrine#93;` params](doctrine#9487) thanks to @steveclifton
 - [9446: Remove trailing underscore](doctrine#9446) thanks to @greg0ire

#### Static Analysis

 - [9557: Parser: SimpleArithmeticExpression should return ArithmeticTerm](doctrine#9557) thanks to @janbarasek
 - [9546: Update baselines for Lexer 1.2.3](doctrine#9546) thanks to @derrabus
 - [9504: Fix AbstractQuery::setParameter phpdoc](doctrine#9504) thanks to @dmaicher
 - [9493: Added "false" value to $columnPrefix type declaration.](doctrine#9493) thanks to @DmytryHo
 - [9491: PHPStan 1.4.6, Psalm 4.20.0](doctrine#9491) thanks to @derrabus

CI
--

 - [9539: Drop minor version number ](doctrine#9539) thanks to @greg0ire
 - [9470: Run Postgres 14 and MariaDB 10.6 in CI](doctrine#9470) thanks to @derrabus

#### Test Suite

 - [9526: Make creating test models more straightforward and revert to swallowing exceptions](doctrine#9526) thanks to @greg0ire
 - [9519: Trigger the desired code path](doctrine#9519) thanks to @lcobucci
 - [9482: Run tests with stricter error handling](doctrine#9482) thanks to @derrabus

### Release Notes for [2.11.1](https://github.com/doctrine/orm/milest…

…one/105)

2.11.x bugfix release (patch)

### 2.11.1

- Total issues resolved: **1**
- Total pull requests resolved: **18**
- Total contributors: **13**

#### Test Suite

 - [9442: Adapt test logic to PHP and SQLite II](doctrine#9442) thanks to @greg0ire
 - [9425: Ignore PHPUnit result cache everywhere](doctrine#9425) thanks to @derrabus
 - [9414: Move UnderscoreNamingStrategyTest to correct namespace](doctrine#9414) thanks to @derrabus

CI
--

 - [9440: Added php 8.1 to CI](doctrine#9440) thanks to @sir-kain

#### Static Analysis

 - [9438: Psalm 4.19.0, PHPStan 1.4.3](doctrine#9438) thanks to @derrabus
 - [9415: Added class-string typehint on $targetEntity](doctrine#9415) thanks to @hc-jworman
 - [9398: Fix type on loadCacheEntry](doctrine#9398) thanks to @derrabus
 - [9393: Update baselines for DBAL 3.3](doctrine#9393) thanks to @derrabus
 - [9385: PHPStan 1.4.0](doctrine#9385) thanks to @derrabus

#### Bug

 - [9419: Fix support for PHP 8.1 enums in embedded classes](doctrine#9419) thanks to @HypeMC
 - [9410: Allow DiscriminatorColumn with length=0](doctrine#9410) thanks to @bcremer
 - [9382: Expose enumType to DBAL to make native DB Enum possible](doctrine#9382) thanks to @javer
 - [9381: &doctrine#91;doctrineGH-9380&doctrine#93; Bugfix: Delegate ReflectionEnumProperty::getAttributes().](doctrine#9381) thanks to @beberlei and @ezkimo

#### Documentation

 - [9390: Introduce &doctrine#95;&doctrine#95;unserialize behaviour in docs](doctrine#9390) thanks to @SenseException
 - [9386: Corrected ORM version and added missing dependency](doctrine#9386) thanks to @mahakaal
 - [9357: Add detach as of list cascade-all operations](doctrine#9357) thanks to @andrew-demb
 - [9311: Accessing private properties and methods from the same class is forbidden](doctrine#9311) thanks to @olsavmic

#### Bug,Missing Tests

 - [9384: Allow using Enum from different namespace than Entity](doctrine#9384) thanks to @javer

### Release Notes for [2.11.0](https://github.com/doctrine/orm/milest…

…one/100)

Feature release (minor)

### 2.11.0

- Total issues resolved: **2**
- Total pull requests resolved: **35**
- Total contributors: **11**

#### Documentation

 - [9368: Fix doc blocks on ID generators](doctrine#9368) thanks to @derrabus

 - [9364: Update branch metadata for 2.11](doctrine#9364) thanks to @derrabus
 - [9328: Document return type of `getEntityState()`](doctrine#9328) thanks to @derrabus
 - [9241: Support for nesting attributes with PHP 8.1](doctrine#9241) thanks to @beberlei
 - [9174: AttributeOverride annotation is also an attribute but that is not reachable](doctrine#9174) thanks to @brzuchal
 - [9118: Generated/Virtual Columns: Insertable / Updateable](doctrine#9118) thanks to @mehldau

#### Improvement

 - [9356: Remove the `composer/package-versions-deprecated` package](doctrine#9356) thanks to @derrabus
 - [9340: Use the readonly annotation](doctrine#9340) thanks to @derrabus
 - [9319: Document LockMode enums](doctrine#9319) thanks to @derrabus
 - [9316: Support readonly properties for read operations](doctrine#9316) thanks to @derrabus
 - [9312: Leverage generic ObjectManagerDecorator](doctrine#9312) thanks to @derrabus
 - [9275: Fix type errors in `AbstractQuery` and `QueryBuilder`](doctrine#9275) thanks to @derrabus
 - [9274: Fix type errors in AnnotationDriver](doctrine#9274) thanks to @derrabus
 - [9273: Fix docblocks on nullable EM properties](doctrine#9273) thanks to @derrabus
 - [9271: Fix return types of cache interfaces](doctrine#9271) thanks to @derrabus
 - [9203: Drop support for DBAL 3.1](doctrine#9203) thanks to @derrabus
 - [9202: Add SchemaIgnoreClasses property](doctrine#9202) thanks to @simPod

#### Bug

 - [9355: Relax assertion to include null as possible outcome](doctrine#9355) thanks to @derrabus

#### Deprecation

 - [9327: Added runtime deprecation to `UnitOfWork::commit()` and `clear()`](doctrine#9327) thanks to @derrabus
 - [9309: &doctrine#91;doctrineGH-9277&doctrine#93; deprecate php driver](doctrine#9309) thanks to @beberlei
 - [9249: Deprecate `Setup::registerAutoloadDirectory()`](doctrine#9249) thanks to @derrabus
 - [9211: Add deprecation hints to `orm:convert-mapping` command](doctrine#9211) thanks to @derrabus
 - [9206: Add missing deprecations for YAML metadata mapping](doctrine#9206) thanks to @derrabus
 - [9074: Deprecate `ensureProductionSettings()`](doctrine#9074) thanks to @derrabus
 - [9072: Deprecate `AbstractHydrator::hydrateRow()`](doctrine#9072) thanks to @derrabus

#### New Feature

 - [9326: Add support for custom types with requireSQLConversion and ResultSetMappingBuilder::generateSelectClause()](doctrine#9326) thanks to @kimhemsoe
 - [9304: Add support for PHP 8.1 enums.](doctrine#9304) thanks to @beberlei
 - [9149: Detect enums and use type string (PHP 8.1 only)](doctrine#9149) thanks to @Nek-
 - [9133: Adding a setup helper for attribute metadata config](doctrine#9133) thanks to @judahnator

#### Deprecation,Improvement

 - [9325: Use `EntityManagerInterface` in type declarations](doctrine#9325) thanks to @derrabus
 - [9322: PSR-6 second level cache](doctrine#9322) thanks to @derrabus

CI
--

 - [9272: Regenerate Psalm baseline](doctrine#9272) thanks to @derrabus
 - [9267: Enable UnusedUse sniff again](doctrine#9267) thanks to @derrabus

#### Bug,DQL

 - [9266: Improve compatibility with Doctrine DBAL 4](doctrine#9266) thanks to @morozov

#### DQL,New Feature

 - [9242: Allow arithmetic expressions within IN operator](doctrine#9242) thanks to @webda2l

#### DQL,Improvement

 - [6476: Allow arithmetic expressions within IN operator](doctrine#6476) thanks to @astepin

### Release Notes for [2.10.5](https://github.com/doctrine/orm/milest…

…one/104)

### 2.10.5

- Total issues resolved: **0**
- Total pull requests resolved: **21**
- Total contributors: **7**

 - [9360: Add errors caused by the lexer update to the baselines](doctrine#9360) thanks to @derrabus
 - [9344: Remove Psalm job for analyzing DBAL 2](doctrine#9344) thanks to @greg0ire
 - [9330: Fix broken type declaration](doctrine#9330) thanks to @derrabus
 - [9295: Fix return type](doctrine#9295) thanks to @derrabus
 - [9294: Fix union type on QueryExpressionVisitorTest::testWalkComparison()](doctrine#9294) thanks to @derrabus
 - [9286: Whitelist composer plugins used by this repository](doctrine#9286) thanks to @derrabus
 - [9283: Allow symfony/cache 6](doctrine#9283) thanks to @derrabus

CI
--

 - [9349: Update Psalm baseline for Persistence 2.3](doctrine#9349) thanks to @derrabus
 - [9341: PHPStan 1.3.3, Psalm 4.18.1](doctrine#9341) thanks to @derrabus
 - [9324: Enable some previously disabled PHPCS rules](doctrine#9324) thanks to @derrabus
 - [9317: Run PHP CodeSniffer on PHP 8.1](doctrine#9317) thanks to @derrabus
 - [9315: Psalm 4.17.0](doctrine#9315) thanks to @derrabus
 - [9314: Run static analysis with language level PHP 8.1](doctrine#9314) thanks to @derrabus
 - [9303: Bump PHPStan & Psalm](doctrine#9303) thanks to @derrabus

#### Bug

 - [9339: Fix field mapping typing](doctrine#9339) thanks to @greg0ire
 - [9285: Fix XML export for `change-tracking-policy`](doctrine#9285) thanks to @Fedik
 - [9244: Put actual value instead of index inside $originalEntityData](doctrine#9244) thanks to @Feolius

#### Improvement

 - [9318: Document PHPUnit mocks with intersection types](doctrine#9318) thanks to @derrabus

#### Documentation

 - [9281: Better explain limitations of DQL "DELETE"](doctrine#9281) thanks to @mpdude
 - [9268: Fix WhereInWalker description to better describe the behaviour of this class](doctrine#9268) thanks to @LuigiCardamone
 - [9243: Removing list "Lifecycle Events"](doctrine#9243) thanks to @ThomasLandauer

Docs: use canonical order for phpdoc tags, add missed semicolon (doct…

…rine#9190)

### Release Notes for [2.10.3](https://github.com/doctrine/orm/milest…

…one/102)

2.10.x bugfix release (patch)

### 2.10.3

- Total issues resolved: **0**
- Total pull requests resolved: **20**
- Total contributors: **13**

#### Documentation

 - [9218: Fix typo assumptio--> assumption](doctrine#9218) thanks to @Florian-Varrin
 - [9166: Remove reverted bc break](doctrine#9166) thanks to @alexander-schranz
 - [9161: Adding Attributes code block](doctrine#9161) thanks to @ThomasLandauer
 - [9159: Merging Lifecycle Callbacks code samples for PHP + XML + YAML](doctrine#9159) thanks to @ThomasLandauer
 - [9158: Removing paragraph on `const`s](doctrine#9158) thanks to @ThomasLandauer
 - [9156: Adding link to Embeddables](doctrine#9156) thanks to @ThomasLandauer
 - [9154: Fixing more links](doctrine#9154) thanks to @ThomasLandauer
 - [9152: Add doctrine/dbal to project composer.json](doctrine#9152) thanks to @chasen
 - [9151: Fixing links in overview table](doctrine#9151) thanks to @ThomasLandauer
 - [9150: Fix markup for variable names](doctrine#9150) thanks to @pwaring
 - [9143: Document BC break](doctrine#9143) thanks to @greg0ire
 - [9131: Overview table for events: Jump links](doctrine#9131) thanks to @ThomasLandauer

CI
--

 - [9212: Suppress Psalm's ReservedWord errors](doctrine#9212) thanks to @derrabus
 - [9195: Use `equal to` instead of `equal of` in `assertSqlGeneration()`](doctrine#9195) thanks to @simPod

 - [9204: Psalm 4.13.1, PHPStan 1.2.0](doctrine#9204) thanks to @derrabus
 - [9146: Remove old use statements](doctrine#9146) thanks to @chapterjason

#### Bug

 - [9198: Add a psalm type for field mapping](doctrine#9198) thanks to @laryjulien
 - [9147: return 0 when there's no metadata to process](doctrine#9147) thanks to @wickedOne

#### Bug,Failing Test

 - [9153: Infer type from field instead of column](doctrine#9153) thanks to @armenio

#### Improvement

 - [9123: Add XSD "orm:columntoken" type in order to support reserved words in column names](doctrine#9123) thanks to @phansys

### Release Notes for [2.10.2](https://github.com/doctrine/orm/milest…

…one/101)

2.10.x bugfix release (patch)

### 2.10.2

- Total issues resolved: **0**
- Total pull requests resolved: **17**
- Total contributors: **11**

CI
--

 - [9139: Upgrade workflows to 1.1.1](doctrine#9139) thanks to @greg0ire
 - [9126: Explicitly pass secrets](doctrine#9126) thanks to @greg0ire
 - [9115: PHP CodeSniffer 3.6.1](doctrine#9115) thanks to @derrabus

#### Documentation

 - [9138: Fix the upgrade guide for 2.8 changes](doctrine#9138) thanks to @stof
 - [9128: Explaining the two major ways to register an event v2](doctrine#9128) thanks to @ThomasLandauer
 - [9113: Fix typo & minor grammar issues in dql-custom-walkers.rst](doctrine#9113) thanks to @PaulCapron
 - [9107: Remove the twitter #doctrine2 hashtag refference](doctrine#9107) thanks to @BackEndTea
 - [9102: Explaining the two major ways to register an event](doctrine#9102) thanks to @ThomasLandauer
 - [9097: Explaining the two major ways to register an event](doctrine#9097) thanks to @ThomasLandauer
 - [9091: Add "@method" annotation for `wrapInTransaction()` method at `EntityManagerInterface`](doctrine#9091) thanks to @phansys
 - [9039: Overview table for events](doctrine#9039) thanks to @ThomasLandauer

 - [9136: Revert "Removing all the occurence of any"](doctrine#9136) thanks to @greg0ire

#### CI,Improvement

 - [9114: Directly reference upstream CS workflow](doctrine#9114) thanks to @greg0ire

#### Improvement

 - [9108: &doctrine#91;Psalm&doctrine#93; always true/false conditions](doctrine#9108) thanks to @orklah

#### Bug

 - [9100: ScalarColumnHydrator](doctrine#9100) thanks to @calvera
 - [9098: Honor INDEX BY construct in Query::toIterable](doctrine#9098) thanks to @ajgarlag
 - [9096: Fix SchemaValidator with abstract child class in discriminator map](doctrine#9096) thanks to @BenMorel