diff --git a/Resources/doc/first_steps.rst b/Resources/doc/first_steps.rst index d688682b..c32dd15b 100644 --- a/Resources/doc/first_steps.rst +++ b/Resources/doc/first_steps.rst @@ -438,7 +438,68 @@ You can use this new method just like the default finder methods of the reposito When using a custom repository class, you still have access to the default finder methods such as ``find()`` and ``findAll()``. +Service Repositories +~~~~~~~~~~~~~~~~~~~~ + +In the previous section, you learnt how to create custom repository classes and how +to get them using ``DocumentManager``. Another way of obtaining a repository instance +is to use the repository as a service and inject it as a dependency into other services. + +.. code-block:: php + + // src/Acme/StoreBundle/Repository/ProductRepository.php + namespace Acme\StoreBundle\Repository; + + use Acme\StoreBundle\Document\Product; + use Doctrine\Bundle\MongoDBBundle\Repository\ServiceDocumentRepository; + use Doctrine\Common\Persistence\ManagerRegistry; + + /** + * Remember to map this repository in the corresponding document's repositoryClass. + * For more information on this see the previous chapter. + */ + class ProductRepository extends ServiceDocumentRepository + { + public function __construct(ManagerRegistry $registry) + { + parent::__construct($registry, Product::class); + } + } + +The ``ServiceDocumentRepository`` class your custom repository is extending allows you to +leverage Symfony's `autowiring`_ and `autoconfiguration`_. To register all your repositories +as services you can use the following service configuration: + +.. configuration-block:: + + .. code-block:: yaml + + services: + _defaults: + autowire: true + autoconfigure: true + + Acme\StoreBundle\Repository\: + resource: '%kernel.root_dir%/../src/Acme/StoreBundle/Repository/*' + + .. code-block:: xml + + + + + + + + + + + .. _`Basic Mapping Documentation`: http://docs.doctrine-project.org/projects/doctrine-mongodb-odm/en/latest/reference/basic-mapping.html .. _`Conditional Operators`: http://docs.doctrine-project.org/projects/doctrine-mongodb-odm/en/latest/reference/query-builder-api.html#conditional-operators .. _`DoctrineFixturesBundle`: http://symfony.com/doc/master/bundles/DoctrineFixturesBundle/index.html .. _`Query Builder`: http://docs.doctrine-project.org/projects/doctrine-mongodb-odm/en/latest/reference/query-builder-api.html +.. _`autowiring`: https://symfony.com/doc/current/service_container/autowiring.html +.. _`autoconfiguration`: https://symfony.com/doc/current/service_container.html#the-autoconfigure-option