# 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](https://github.com/Atlantic18/DoctrineExtensions/issues/2055) 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](https://github.com/Atlantic18/DoctrineExtensions/issues/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`](/src/SoftDeleteable/Mapping/Event/SoftDeleteableAdapter.php) interface has a new method
for generating the DateTime value.