You are browsing a version that is no longer maintained.

Document Repositories

A repository mediates between the domain and data mapping layers using a collection-like interface for accessing domain objects.

In Doctrine, a repository is a class that concentrates code responsible for querying and filtering your documents. ODM provides you with a default DocumentRepository for all of your documents:

1<?php /* @var $repository \Doctrine\ODM\MongoDB\DocumentRepository */ $repository = $documentManager->getRepository(User::class); $disabledUsers = $repository->findBy(['disabled' => true, 'activated' => true]);
2
3
4
5

The array passed to findBy specifies the criteria for which documents are matched. ODM will assist with converting PHP values to equivalent BSON types whenever possible:

1<?php $group = $documentManager->find(Group::class, 123); /* @var $repository \Doctrine\ODM\MongoDB\DocumentRepository */ $repository = $documentManager->getRepository(User::class); $usersInGroup = $repository->findBy(['group' => $group]);
2
3
4
5

The default repository implementation provides the following methods:

  • find() - finds one document by its identifier. This may skip a database query

if the document is already managed by ODM. - findAll() - finds all documents in the collection. - findBy() - finds all documents matching the given criteria. Additional query options may be specified (e.g. sort, limit, skip). - findOneBy() - finds one document matching the given criteria. - matching() - Finds all documents matching the given criteria, as expressed with Doctrine's Criteria API.

All above methods will include additional criteria specified by Filters.

Custom Repositories

A custom repository allows filtering logic to be consolidated into a single class instead of spreading it throughout a project. A custom repository class may be specified for a document class like so:

  • PHP
    1<?php namespace Documents; /** @Document(repositoryClass="Repositories\UserRepository") */ class User { /* ... */ }
    2
    3
    4
    5
    6
    7
    8
    9
  • XML
    1<document name="Documents\User" repository-class="Repositories\UserRepository"> <!-- ... --> </document>
    2
    3

The next step is implementing your repository class. In most cases, ODM's default DocumentRepository class may be extended with additional methods that you need. More complex cases that require passing additional dependencies to a custom repository class will be discussed in the next section.

1<?php namespace Repositories; class UserRepository extends DocumentRepository { public function findDisabled(): array { return $this->findBy(['disabled' => true, 'activated' => true]); } }
2
3
4
5
6
7
8
9
10
11

It is also possible to change ODM's default DocumentRepository to your own implementation for all documents (unless overridden by the mapping):

1$documentManager->getConfiguration() ->setDefaultRepositoryClassName(MyDefaultRepository::class);
2

Repositories with Additional Dependencies

Implementing your own RepositoryFactory is possible since version 1.0, but the AbstractRepositoryFactory class used in this example is only available since 1.2.

By default, Doctrine assumes that it can instantiate your repositories in same manner as its default one:

1<?php namespace Repositories; class UserRepository extends DocumentRepository { public function __construct(DocumentManager $dm, UnitOfWork $uow, ClassMetadata $classMetadata) { /* constructor is inherited from DocumentRepository */ /* ... */ } }
2
3
4
5
6
7
8
9
10
11
12

In order to change the way Doctrine instantiates repositories, you will need to implement your own RepositoryFactory

1<?php use Doctrine\ODM\MongoDB\Repository\AbstractRepositoryFactory; use Symfony\Component\EventDispatcher\EventDispatcherInterface; final class YourRepositoryFactory extends AbstractRepositoryFactory { private $eventDispatcher; public function __construct(EventDispatcherInterface $eventDispatcher) { $this->eventDispatcher = $eventDispatcher; } protected function instantiateRepository(string $repositoryClassName, DocumentManager $documentManager, ClassMetadata $metadata) { switch ($repositoryClassName) { case UserRepository::class: return new UserRepository($this->eventDispatcher, $documentManager, $metadata); default: return new $repositoryClassName($documentManager, $documentManager->getUnitOfWork(), $metadata); } } }
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

The factory class must then be registered in the Configuration:

1<?php $eventDispatcher = $container->get('event_dispatcher'); $repoFactory = new YourRepositoryFactory($eventDispatcher); $configuration = new Configuration(); // your other config here $configuration->setRepositoryFactory($repoFactory);
2
3
4
5
6
7