NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1217 most downloaded on Packagist
PHP Doctrine MongoDB Object Document Mapper (ODM) provides transparent persistence for PHP objects to MongoDB.
Latest stable
2.17.4
Last release 27 days ago
26 Oct 2026
Release timing varies
gaps range from 1 weeks to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
121 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Total pull requests resolved: 1
2.17.x bugfix release (patch)
Total pull requests resolved: 1
2.17.x bugfix release (patch)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Total pull requests resolved: 4
3040: Revert "Deprecate external write access to read-only metadata properties" thanks to @GromNaN
2.17.x bugfix release (patch)
3011: Deprecate COLLECTION_PER_CLASS inheritance type thanks to @GromNaN
Feature release (minor)
--wait option to odm:schema:create and odm:schema:update thanks to @GromNaNautoEmbed support for vector search indexes and $vectorSearch stage thanks to @GromNaNTotal pull requests resolved: 1
2.16.x bugfix release (patch)
odm:schema:drop --class=... dropping the entire database thanks to @GromNaNTotal pull requests resolved: 4
2.16.x bugfix release (patch)
Total pull requests resolved: 1
2.16.x bugfix release (patch)
SearchIndexMapping thanks to @paulinevos2958: Deprecate array syntax for discriminator field thanks to @IonBazan
doctrine/cache to optional dependencies thanks to @GromNaNPersistentCollection implement Selectable thanks to @GromNaN#[MappedSuperclass] handles custom collection name thanks to @llaffont-compiAnnotations to Attribute thanks to @GromNaNThis deprecations prepare the future major release
Type::closureToPHP() thanks to @GromNaNConfiguration::getProxyDir and setProxyDir thanks to @GromNaNSearchIndex, Validation and VectorSearchIndex as soft-final thanks to @IonBazan->sleep method of ClassMetadata or PersistentCollection thanks to @GromNaNdoctrine/collections v1 thanks to @GromNaNTotal pull requests resolved: 2
2.15.x bugfix release (patch)
2957: Deprecate remaining namespace alias methods thanks to @IonBazan
2.15.x bugfix release (patch)
Total issues resolved: 0
Total pull requests resolved: 5
Total contributors: 2
2963: Fix provideProxiedExprMethods provider thanks to @IonBazan
2957: Deprecate remaining namespace alias methods thanks to @IonBazan
2917: Run tests with PHP 8.5 and fix deprecations thanks to @GromNaN
2.15.x bugfix release (patch)
#[QueryResultDocument] to the attributes reference thanks to @GromNaN2883: Deprecate `ClassMetadataFactoryInterface::setProxyClassNameResolver()` thanks to @GromNaN
Feature release (minor)
ClassMetadataFactoryInterface::setProxyClassNameResolver() thanks to @GromNaNsymfony/var-exporter: 8.0, without lazy ghost object support thanks to @GromNaNClassMetadata::isIdGeneratorUuid() thanks to @GromNaNTotal pull requests resolved: 1
2.14.x bugfix release (patch)
Total pull requests resolved: 4
2.14.x bugfix release (patch)
useLazyGhostObject option is false when useNativeLazyObject is true thanks to @GromNaN2840: Add support for PHP 8.4 Lazy Objects with configuration flag and deprecate not using it with PHP 7.4+ thanks to @GromNaN
Feature release (minor)
src/ directory thanks to @GromNaNTotal pull requests resolved: 1
2.13.x bugfix release (patch)
Total pull requests resolved: 3
2.13.x bugfix release (patch)
$vectorSearch stage thanks to @GromNaNuse-next-minor-as-default-branch in release job thanks to @GromNaN2823: Deprecate `Stage::search()` because the `$search` stage must be the first of the pipeline thanks to @GromNaN
Feature release (minor)
$vectorSearch aggregation builderfilter and queryVector parameter in $vectorSearch stage builder thanks to @GromNaNType::closureToMongo() and closureToPHP() thanks to @GromNaN$search or $vectorSearch pipeline returns an empty result thanks to @GromNaNSchemaManager::waitForSearchIndexes() thanks to @GromNaNObjectId as version field thanks to @GromNaNcompound search operator thanks to @GromNaN$vectorSearch aggregation thanks to @GromNaNClassMetadata and DocumentPersister thanks to @GromNaNStage::search() because the $search stage must be the first of the pipeline thanks to @GromNaNTotal pull requests resolved: 3
2.12.x bugfix release (patch)
2811: Update test using deprecated field type `integer` thanks to @GromNaN
2.12.x bugfix release (patch)
integer thanks to @GromNaN2773: Deprecate `APM\Command::getServer()`, add `getPort()` and `getHost()` instead thanks to @GromNaN
Feature release (minor)
$search aggregation with searchBefore and searchAfter markers thanks to @bitgandtterClassLocator from Doctrine Persistence 4.1 in the attribute and annotation drivers thanks to @GromNaNassert calls thanks to @GromNaNAPM\Command::getServer(), add getPort() and getHost() instead thanks to @GromNaNTotal pull requests resolved: 4
2.11.x bugfix release (patch)
Total pull requests resolved: 1
2.11.x bugfix release (patch)
Total pull requests resolved: 4
2.11.x bugfix release (patch)
ReflectionMethod::setAccessible in tests thanks to @GromNaNTotal pull requests resolved: 8
Feature release (minor)
$geoNear stage with empty query thanks to @GromNaN$text operator in a aggregation with a filter thanks to @GromNaN$match from pipeline builder thanks to @GromNaNspl_object_hash with spl_object_id thanks to @GromNaN
BC break: DocumentPersister::getInserts() and DocumentPersister::getUpserts() return array<int, object> instead of array<string, object>.Total pull requests resolved: 4
2.10.x bugfix release (patch)
2746: Fix RST formatting for warning content thanks to @jmikola
2736: Create UTCDateTime from DateTimeInterface directly thanks to @GromNaN
2735: Improve comment in generated code thanks to @GromNaN
$config variable thanks to @GromNaNThis release fixes an issue when inserting documents with a pre-defined _id field into time series collections.
This release fixes an issue when inserting documents with a pre-defined _id field into time series collections.
Total pull requests resolved: 8
Feature release (minor)
LazyGhostTrait thanks to @GromNaN2696: Ensure compatibility with persistence 4 thanks to @greg0ire
2687: Support mapping time series collections thanks to @alcaeus
Total pull requests resolved: 3
2.9.x bugfix release (patch)
2693: Remove usage of deprecated `ReadPreference::RP_*` constants thanks to @GromNaN
2.9.x bugfix release (patch)
ReadPreference::RP_* constants thanks to @GromNaNwrapTransversable generators to prevent memory leaks thanks to @GromNaNThis release mainly updates documentation. Included is a change to how date fields are compared when computing change sets. As a result, sub-second ch
This release mainly updates documentation. Included is a change to how date fields are compared when computing change sets. As a result, sub-second changes are now also detected correctly and cause an update to the document in the database.
Total issues resolved: 0
Total pull requests resolved: 20
Total contributors: 3
2676: Fixes changeset being empty when datetime change is sub second thanks to @magnetik
2675: Merge release 2.8.2 into 2.9.x thanks to @github-actions[bot]
ResolveTargetDocumentListener thanks to @GromNaNTotal pull requests resolved: 1
2.8.x bugfix release (patch)
This release fixes issues with schema management on non-Atlas clusters.
This release fixes issues with schema management on non-Atlas clusters.
Total issues resolved: 0
Total pull requests resolved: 2
Total contributors: 2
2671: Gracefully handle search index exceptions if possible thanks to @alcaeus
This release adds support for Atlas Search Indexes in mappings and schema managers. Support for MongoDB 4.4 has been dropped; the minimum supported ve
This release adds support for Atlas Search Indexes in mappings and schema managers. Support for MongoDB 4.4 has been dropped; the minimum supported version is now MongoDB 5.0.
2641: Decouple UnitOfWork from Hydrators thanks to @alcaeus
2617: Drop support for MongoDB 4.4 thanks to @malarzm
2630: Support search indexes in mappings and SchemaManager thanks to @jmikola
2622: Fix deprecation notices Indexes annotation thanks to @jmikola
2.7.x bugfix release (patch)
2638: Fix link target in Index annotation docs thanks to @jmikola
2637: Fix RST indent for Document annotation writeConcern option thanks to @jmikola
2636: Fix of static analysis errors thanks to @SenseException
2629: Remove duplicate keys in data providers thanks to @alcaeus and @jmikola
2620: Fix CI thanks to @malarzm
This release introduces support for transactions when calling DocumentManager::flush.
This release introduces support for transactions when calling DocumentManager::flush.
doctrine/persistence 3 thanks to @franmomu2586: Transaction support thanks to @alcaeus
1888: Transaction support thanks to @Steveb-p
2502: Decouple AttributeDriver from AnnotationDriver thanks to @franmomu
doctrine/annotations dependency optional thanks to @franmomuTotal pull requests resolved: 1
2.6.x bugfix release (patch)
Total pull requests resolved: 1
2.6.x bugfix release (patch)
Total pull requests resolved: 1
2.6.x bugfix release (patch)
2584: Deprecate DocumentRepository::clear thanks to @alcaeus and @TranquilCapybara16493
This release adds a number of aggregation pipeline stages and operators to the aggregation builder. It now supports Atlas Search using the $search aggregation pipeline stage, as well as the $densify, $fill, and $setWindowFields stages.
Support for PHP 7.4 and PHP 8.0 has been dropped, and the library now requires PHP 8.1 or newer.
Total issues resolved: 3
Total pull requests resolved: 19
Total contributors: 7
2584: Deprecate DocumentRepository::clear thanks to @alcaeus and @TranquilCapybara16493
2579: Aggregation uses CursorInterface instead of Cursor thanks to @alcaeus
2517: Add $setWindowFields aggregation pipeline stage and window operators thanks to @alcaeus
2516: Add $search stage to aggregation pipeline builder thanks to @alcaeus
Total pull requests resolved: 2
Total pull requests resolved: 5
Total pull requests resolved: 3
Total pull requests resolved: 2
Query::__construct() can not use an empty array as default value thanks to @phansys2511: Avoid triggering deprecation when calling `UnitOfWork::clear()` thanks to @franmomu
2.5.x bugfix release (patch)
UnitOfWork::clear() thanks to @franmomuTotal pull requests resolved: 22
doctrine/annotations 2 thanks to @franmomudoctrine/instantiator 2 thanks to @franmomu2478: Support doctrine/event-manager 2.x thanks to @malarzm
2472: Add warning about potential signature incompatibility thanks to @greg0ire
2485: Fix deprecation notices in CommandLogger thanks to @IonBazan
Total pull requests resolved: 1
Total pull requests resolved: 2
2434: Deprecate NOTIFY tracking policy thanks to @malarzm
Feature release (minor)
Query namespace thanks to @franmomuTotal pull requests resolved: 2
2403: Allow more recent symfony/deprecation-contracts thanks to @quentint
2.3.x bugfix release (patch)
Total pull requests resolved: 4
2.3.x bugfix release (patch)
2379: Remove deprecated "boolean" mapping type in docs thanks to @samnela
Feature release (minor)
PersistentCollectionInterface and PersistentCollection generic thanks to @franmomuDocumentRepository thanks to @franmomuDocumentManager::getReference thanks to @franmomu2333: Add return static thanks to @franmomu
2330: Add more phpdoc type info thanks to @franmomu
2328: Improve type declarations in phpdoc thanks to @franmomu
2305: Merge release 2.2.1 into 2.3.x thanks to @github-actions[bot]
Total pull requests resolved: 4
Total issues resolved: 1
Total pull requests resolved: 4
Total contributors: 4
2390: Reuse workflows from upstream thanks to @greg0ire
Total pull requests resolved: 6
2.2.x bugfix release (patch)
Total pull requests resolved: 11
nullable for embedded document thanks to @wuchen902271: Deprecate mapping relations with targetDocument and discriminatorMap thanks to @alcaeus
2244: Fix trigger_error level when deprecated type is used thanks to @rieschl
One column per quarter.