New Website

Posted on 2018-04-06 by Jonathan H. Wage

In 2007 Doctrine got its first official website at Before that, the website was an instance of Trac which also served as our documentation, issue tracker and project management tool.

The new website design was created by Phu Son Nguyen who worked at Yahoo! at the time. It was a huge step forward for the Doctrine Project and it gave us 10 solid years!

Fast-forward and today we are happy to be launching a new foundation for our website and documentation. In addition to the new look, here are some new features:

  • GitHub Edit links on all documentation pages to make it easy to contribute fixes when you come across something that could be improved.
  • Automated deploys with GitHub Pages. Simply create a pull request and it will be deployed to Merges to master automatically deploy to
  • Search powered by Algolia.
  • Mobile friendly.
  • Documentation supports multiple versions.
  • Documentation user experience improvements.

We hope that this helps improve the experience and make it easier to contribute. The code for the site is open source and can be found here. If you want to contribute to the documentation for a project, you can find the docs in a folder named /docs in the root of the project repository. Here is the ORM for example.

If you discover any issues, please report them on the GitHub Issue tracker for the project.

Doctrine ORM 2.6 and Next (3.0)

Posted on 2017-12-21 by Mike Simonson

We are happy to announce the immediate availability of Doctrine ORM 2.6.0.

ORM 2.6.0

This release contains almost 3 years of active development and it provides several improvements and fixes, including:

  • Better commit order calculation
  • More stable second level cache
  • Strict testing and quality control
  • PHP 7.1+ requirement



This release marks the feature freeze of the 2.x version.

If you need to improve please work on the develop branch that will become the 3.0 branch in the coming days. The changes are already too numerous to easily rebase a feature from the 2.x branch to the develop one.

Doctrine MongoDB ODM 1.2.0 and 1.1.7 Released

Posted on 2017-10-24 by Andreas Braun

We are happy to announce the immediate availability of Doctrine MongoDB ODM 1.2.0 and 1.1.7.

MongoDB ODM 1.1.7

Notable fixes may be found in the changelog. A full list of issues and pull requests included in this release may be found in the 1.1.7 milestone.

What is new in 1.2.0?

Doctrine MongoDB ODM 1.2.0 introduces the following new features:

  • The readOnly mapping option allows you to map immutable documents.
  • With slaveOkay being deprecated, you can now specify a readPreference for your documents. This readPreference will automatically be applied to all queries for those mapped documents.
  • With dbRef only offering limited support in aggregation pipeline queries, there's a new reference storage strategy called ref that stores references as objects (without "\$"-prefixed field names), allowing you to use it with discriminators and aggregation pipeline queries.
  • When mapping inverse references, you may now specify fields that will be primed when the reference is resolved. This saves you from writing a dedicated repository method for the sole purpose of priming references.
  • The odm:schema:validate command validates the document mapping to help you spot mistakes.
  • A new builder for aggregation pipeline queries, including support for marshalling results into read-only documents.
  • Query result documents that can be used to hydrate results from an aggregation pipeline query. These documents cannot be written back to the database.

Upgrading to 1.2.0

The new version requires PHP 5.6. Running on PHP 7+ requires the use of a polyfill for the legacy driver, e.g. mongo-php-adapter. When running on PHP 5.6, MongoDB ODM requires version 1.6.7 or newer of the legacy MongoDB driver.

Several features have been deprecated in this release and will be dropped in the 2.0 release. To see this, please view the UPGRADE document.


You can install the new version of MongoDB ODM by using Composer and the following composer.json contents:

    "require": {
        "doctrine/mongodb-odm": "^1.2.0"

Stability and upcoming releases

As of today, Doctrine MongoDB ODM 1.2.0 is the stable distribution. There is no release schedule for an upcoming version yet.

1.1.7 is the last release of the 1.1.x development line and will no longer receive bug fixes. Instead, we will focus on developing MongoDB ODM 2.0 with native support for the new MongoDB driver. This release will require at least PHP 7.1 and contain several BC breaking changes. To ease the migration process, we will release a 1.3.0 which will be backwards compatible to the 1.2.x line and only deprecate features to be removed in 2.0. The 1.x line of MongoDB ODM will not receive any new features.