NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #1243 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 22 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: 4
Release 2.1.2
convertToDatabaseValue thanks to @alanpoulainTotal pull requests resolved: 1
Release 2.1.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
[2011: [2.1] Deprecate AbstractIdGenerator](https://github.com/doctrine/mongodb-odm/pull/2011) thanks to @malarzm
Release 2.1.0
2185: Favour int over int_id thanks to @malarzm
2184: Introduce Versionable interface thanks to @malarzm
2183: Favour bool and int over boolean and integer thanks to @malarzm
2127: More tests for date_immutable type thanks to @malarzm
2126: Merge release 2.0.3 into master thanks to @doctrinebot
Total pull requests resolved: 2
Release 2.0.6
Total issues resolved: 1
Total pull requests resolved: 2
Total contributors: 2
2187: Merge release 1.3.7 into 2.0.x thanks to @doctrinebot
Total pull requests resolved: 1
Release 2.0.5
2150: Address deprecations from persistence thanks to @greg0ire
Release 2.0.4
Total pull requests resolved: 5
Release 2.0.3
Total issues resolved: 1
Total pull requests resolved: 5
Total contributors: 6
2125: Merge release 1.3.5 into 2.0.x thanks to @doctrinebot
Total pull requests resolved: 3
Total pull requests resolved: 1
Total pull requests resolved: 3
…BC breaks introduced in 2.0 and will warn you of deprecated features. This release will be the last release of the 1.x line and is meant to ease migra…
We are happy to announce the first Beta Release of Doctrine MongoDB ODM 2.0. As this is still a pre-release version, please do not run it in production. Errors and performance issues may occur. The public API is now considered stable, although BC breaks may happen due to bugs or performance issues.
The API is now considered stable, which means that we'll preserve BC for any features in Beta 1. BC breaks may happen if they are necessary to fix bugs in newly introduced functionality or performance issues. The main change is that proxy objects no longer implement the Doctrine proxy interface but rather the GhostObjectInterface from ocramius/proxy-manager. You only need to make changes if you interact with proxies manually. In that case, you need to update your proxy checks and any calls to proxy objects that deal with the proxy architecture.
Before we can build a release candidate, we want to ensure that the performance of the library does not suffer from regressions. Thus, work will focus on building a performance test suite to ensure this. If you notice any performance issues in this release, please create an issue in our issue tracker. At the same time, we will work on MongoDB ODM 1.3, which will contain a forward compatibility layer for BC breaks introduced in 2.0 and will warn you of deprecated features. This release will be the last release of the 1.x line and is meant to ease migration to 2.0 and provides a longer support window for people who can't upgrade to PHP 7.2 yet.
You can install this version of MongoDB ODM by using Composer and the following composer.json contents:
{
"require": {
"doctrine/mongodb-odm": "^2.0@beta"
}
}
We will try to not break BC once we've entered the beta stage. Among the breaking changes planned until Beta 1 is a rewrite of the proxy logic to no l…
We are happy to announce the first Alpha Release of Doctrine MongoDB ODM 2.0. As this is still a pre-release version, please do not run it in production. Errors and performance issues may occur, and the public API may still change until the beta stage.
The main difference is that you no longer need an adapter to run on PHP 7. ODM now uses the new MongoDB driver by default. We have also completely rewritten GridFS support, updated our code to use type hints and we now use PHPStan to better inspect our code and prevent bugs.
To see the full list of changes and how to upgrade, please see the UPGRADE document.
All issues and pull requests in this release may be found under the 2.0 milestone.
The next release will be Beta 1, at which time the API will be finalised. We will try to not break BC once we've entered the beta stage. Among the breaking changes planned until Beta 1 is a rewrite of the proxy logic to no longer use doctrine/common for proxies.
You can install this version of MongoDB ODM by using Composer and the following composer.json contents:
{
"require": {
"doctrine/mongodb-odm": "^2.0@alpha"
}
}
Total pull requests resolved: 4
1956: Remove previously deprecated operations from Query Builder thanks to @jmikola
addFields method for Stage abstract thanks to @Steveb-p2159: Deprecation and forward compat for flush thanks to @malarzm
Release 1.3.7
Total pull requests resolved: 3
Release 1.3.6
Total pull requests resolved: 2
Release 1.3.5
Total pull requests resolved: 1
Release 1.3.4
Total pull requests resolved: 2
Total pull requests resolved: 2
Total pull requests resolved: 0
2064: Add missing deprecation notice for incomplete embedded associations thanks to @alcaeus
2022: Reword most deprecation notices thanks to @alcaeus
Total pull requests resolved: 3
Total pull requests resolved: 2
Total pull requests resolved: 2
1971: Clarify deprecation of update() and multiple() thanks to @alcaeus
Total pull requests resolved: 3
1919: Replace the deprecated comment thanks to @etshy
Please see changelog for a complete list of fixes.
Maintenance release.
Please see changelog for a complete list of fixes.
All issues and pull requests in this release may be found under the 1.2.5 milestone.
Please see changelog for a complete list of fixes.
Maintenance release.
Please see changelog for a complete list of fixes.
All issues and pull requests in this release may be found under the 1.2.4 milestone.
Re-tag of 1.2.2 which was inadvertently tagged from master. There are no other changes included in this release.
Re-tag of 1.2.2 which was inadvertently tagged from master. There are no other changes included in this release.
This release fixes usage of MongoDB ODM on MongoDB 3.6.
This release fixes usage of MongoDB ODM on MongoDB 3.6.
Please see changelog for a complete list of fixes.
All issues and pull requests in this release may be found under the 1.2.1 milestone.
We are happy to announce the availability of Doctrine MongoDB ODM 1.2.0.
We are happy to announce the availability of Doctrine MongoDB ODM 1.2.0.
Please see the UPGRADE document for notable changes.
All issues and pull requests in this release may be found under the 1.2 milestone.
You can install this version of MongoDB ODM by using Composer and the following composer.json contents:
{
"require": {
"doctrine/mongodb-odm": "^1.2.0"
}
}
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.7 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.6 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.5 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.4 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.3 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.2 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.1.1 milestone.
Due to the requirement changes introduced with MongoDB ODM 1.1.0 we have decided to provide bug fixes as well as security fixes for MongoDB ODM 1.0.x…
We are happy to announce the availability of Doctrine MongoDB ODM 1.1.0.
Doctrine MongoDB ODM 1.1.0 comes with the following new features:
Running MongoDB ODM on PHP 7 requires the new MongoDB driver (ext-mongodb) which is not directly compatible with ODM. To solve this, you can use a polyfill like mongo-php-adapter, which provides the legacy driver API on top of the new driver. To do so, in your PHP 7 project, add the following Composer directives in addition to the MongoDB ODM requirement:
{
"require": {
"alcaeus/mongo-php-adapter": "^1.0",
"ext-mongo": "*"
}
}
Due to a bug in Composer you need to include a requirement to ext-mongo. This requirement will be correctly filled by
mongo-php-adapter.
The new version requires PHP 5.6+; older versions are no longer supported. If you are using an older version, please use Doctrine MongoDB ODM 1.0.x or upgrade your PHP version. In addition to these PHP version changes, MongoDB ODM 1.1.0 requires version 1.5 or newer of the legacy MongoDB driver. The new MongoDB driver is supported a polyfill (like mongo-php-adapter mentioned above).
To use custom collection classes, you must set a persistentCollectionDir in the configuration. This is an optional feature and is not required by default.
Several features have been deprecated and will be dropped in the 2.0 release:
@String) have been deprecated. Please use the @Field annotation instead.Increment type has been deprecated in favor of a storage strategy combined with the Integer and Float typesimple flag for references has been replaced with storeAs, allowing more flexibility.You can install this version of MongoDB ODM by using Composer and the following composer.json contents:
{
"require": {
"doctrine/mongodb-odm": "^1.1.0"
}
}
As of today, Doctrine MongoDB ODM 1.1.0 is the stable distribution. There is no release schedule for an upcoming version yet.
Due to the requirement changes introduced with MongoDB ODM 1.1.0 we have decided to provide bug fixes as well as security fixes for MongoDB ODM 1.0.x for an additional 6 months. After that, 1.0.x will no longer be supported.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.0.8 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.0.7 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.0.6 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.0.5 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.0.4 milestone.
Please see changelog for notable fixes
Maintenance release.
Please see changelog for notable fixes
All issues and pull requests in this release may be found under the 1.0.3 milestone.
Note: this release addresses a known security vulnerability
Note: this release addresses a known security vulnerability
All issues and pull requests in this release may be found under the 1.0.2 milestone.
#1223 resolved a security vulnerability related to file and directory creation in ODM. Doctrine Common and ORM are also affected, so users are encouraged to update all libraries and dependencies. The vulnerability has been assigned CVE-2015-5723 and additional information on the issue may be found in this blog post.
This release fixes a regression where running Cursor::count() returned the wrong count for the query by default.
This release fixes a regression where running Cursor::count() returned the wrong count for the query by default.
Requires Doctrine MongoDB 1.2.x.
Requires Doctrine MongoDB 1.2.x.
This is a stable release. From now on, the project will follow semantic versioning.
See changelog for additional release notes.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Forward compatibility with Symfony 3.0
Forward compatibility with Symfony 3.0
See changelog for additional release notes.
Allow compatibility with minor versions of Doctrine Common beyond 2.4.
Allow compatibility with minor versions of Doctrine Common beyond 2.4.
See changelog for additional release notes.
Requires Doctrine Common 2.4.x and Doctrine MongoDB 1.1.x.
Requires Doctrine Common 2.4.x and Doctrine MongoDB 1.1.x.
Includes a compatibility fix for PHP 5.4.29 and 5.5.13.
See changelog for additional release notes.
One column per quarter.