Skip to content

Latest commit

 

History

History
39 lines (24 loc) · 1.66 KB

upgrade-v2.4-to-v3.0.md

File metadata and controls

39 lines (24 loc) · 1.66 KB

Upgrading Doctrine Extensions: from v2.4.x to v3.0

Doctrine Extensions v3.0 is primarily focused on upgrading toolsets and dependencies, to make future work easier and more compatible with modern PHP versions.

Most users will not need significant development time and effort to upgrade to v3.0. Look for "Applies To" notes for when you may need to take action.

Known Issue: Doctrine MongoDB ODM 2.0 Mapping Drivers

ODM 2.0 made significant changes to parts of their mappers. The YAML driver was removed completely, and the XML driver added schema validation that does not allow mixing of native ODM and Extensions elements.

YAML and XML mapping users may not be able to use Doctrine Extensions 3.0, which does not attempt to resolve these issues at the time. If you use Annotations or PHP mapping drivers, you should be unaffected.

See Issue #2055 on GitHub for more information. Please leave a message if this affects your project.

PHP 7.2 Required

Applies To: Everyone

PHP 7.1 is no longer maintained as of December 2019.

MongoDB

Applies To: Projects using DoctrineExtension with MongoDB

  • Requires the ext-mongodb PHP extension. Usage of ext-mongo is deprecated and will be removed in the next major version.
  • Minimum Doctrine MongoDB ODM requirement of 2.0

SoftDeleteable

Applies To: Projects with a custom SoftDeleteableAdapter implementation

The SoftDeleteableAdapter interface has a new method for generating the DateTime value.