Skip to content

Latest commit

 

History

History
32 lines (24 loc) · 1.46 KB

UPGRADE-2.2.md

File metadata and controls

32 lines (24 loc) · 1.46 KB

UPGRADE FROM 2.1 to 2.2

Aggregation

The new Doctrine\ODM\MongoDB\Aggregation\Builder::getAggregation() method returns an Doctrine\ODM\MongoDB\Aggregation\Aggregation instance, comparable to the Query class.

The Doctrine\ODM\MongoDB\Aggregation\Builder::execute() method was deprecated and will be removed in ODM 3.0.

The Doctrine\ODM\MongoDB\Aggregation\Stage\Match and Doctrine\ODM\MongoDB\Aggregation\Stage\GraphLookup\Match classes were deprecated and replaced by Doctrine\ODM\MongoDB\Aggregation\Stage\MatchStage and Doctrine\ODM\MongoDB\Aggregation\Stage\GraphLookup\MatchStage respectively. This change was necessary due to match being a reserved keyword in PHP 8. You must replace any usage of this class before you migrate to PHP 8.

Document indexes (annotations)

Using @Index annotation(s) on a class level is a preferred way for defining indexes for documents. Using @Index in the @Indexes annotation or an indexes property of other annotations was deprecated and will be removed in ODM 3.0.

DocumentManager configuration

Using doctrine/cache to cache metadata is deprecated in favor of using PSR-6. The getMetadataCacheImpl and setMetadataCacheImpl methods in Doctrine\ODM\MongoDB\Configuration have been deprecated. Please use getMetadataCacheand setMetadataCache with a PSR-6 implementation instead. Note that even after switching to PSR-6, getMetadataCacheImpl will return a cache instance that wraps the PSR-6 cache.