Skip to content

Latest commit

 

History

History
62 lines (45 loc) · 2.44 KB

UPGRADE-5.0.md

File metadata and controls

62 lines (45 loc) · 2.44 KB
Raw

UPGRADE FROM 4.x to 5.0

PHP version and dependencies

  • Add support for Symfony 7.0 and require at least Symfony 6.4
  • doctrine/mongodb-odm 2.6 and doctrine/persistence 3.0 are required

Annotations

  • Remove support of Annotation mapping, you should use Attributes or XML instead.

Commands

  • All command and compiler pass classes are internal and final. They cannot be used directly or extended.
  • The doctrine:mongodb:tail-cursor command and Doctrine\Bundle\MongoDBBundle\Cursor\TailableCursorProcessorInterface interface have been dropped. You should use change streams instead.
  • The setContainer, getContainer, getDoctrineDocumentManagers, findBundle and findBasePathForBundle methods from Doctrine\Bundle\MongoDBBundle\Command\DoctrineODMCommand have been removed without replacement.

Configuration

Remove all doctrine_mongodb.odm.* parameters.

Deprecated options have been removed:

namespace removed replaced by
default_commit_options fsync j
default_commit_options safe w
connections.*.options fsync journal
connections.*.options slaveOkay readPreference
connections.*.options timeout connectTimeoutMS
connections.*.options wTimeout wTimeoutMS

Event Subscriber

  • Remove Doctrine\Bundle\MongoDBBundle\EventSubscriber\EventSubscriberInterface. Use the #[AsDocumentListener] attribute instead.
  • Remove parameters $method and $lazy of #[AsDocumentListener], they are not used.

Fixtures

  • Remove --service option from doctrine:mongodb:fixtures:load command
  • Remove automatic injection of the container in fixtures classes implementing ContainerAwareInterface. You should use dependency injection instead.
  • Remove the fixture_loader configuration

Cache

The Doctrine\Common\Cache\ providers are not supported anymore. The configuration uses Symfony\Component\Cache\Adapter\ providers instead, for PSR-6 compatibility.

If you want to use redis or memcached, the configuration of host, port and instance_class must be done for each document manager. The parameters doctrine_mongodb.odm.cache.memcached_* and doctrine_mongodb.odm.cache.redis_* are not read anymore.