You are browsing a version that is no longer maintained.

Entity Listeners

Entity listeners that are services must be registered with the entity listener resolver. On top of the annotation in the entity class, you have to tag the service with doctrine.orm.entity_listener for it to be automatically added to the resolver. Use the (optional) entity_manager attribute to specify which entity manager it should be registered with.

Full example:

  • ANNOTATION
    1<?php // User.php use Doctrine\ORM\Mapping as ORM; use App\UserListener; /** * @ORM\Entity * @ORM\EntityListeners({UserListener::class}) */ class User { // .... }
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
  • ATTRIBUTE
    1<?php // User.php use Doctrine\ORM\Mapping as ORM; use App\UserListener; #[ORM\Entity] #[ORM\EntityListeners([UserListener::class])] class User { // .... }
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
  • YAML
    1services: App\UserListener: tags: # Minimal configuration below - { name: doctrine.orm.entity_listener } # Or, optionally, you can give the entity manager name as below #- { name: doctrine.orm.entity_listener, entity_manager: custom }
    2
    3
    4
    5
    6
    7
  • XML
    1<?xml version="1.0" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <services> <service id="App\UserListener"> <!-- entity_manager attribute is optional --> <tag name="doctrine.orm.entity_listener" entity_manager="custom" /> </service> </services> </container>
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

Starting with doctrine/orm 2.5 and Doctrine bundle 1.5.2, instead of registering the entity listener on the entity, you can declare all options from the service definition:

  • YAML
    1services: App\UserListener: tags: - name: doctrine.orm.entity_listener event: preUpdate entity: App\Entity\User # entity_manager attribute is optional entity_manager: custom # method attribute is optional method: validateEmail
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
  • XML
    1<?xml version="1.0" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <services> <service id="App\UserListener"> <!-- entity_manager attribute is optional --> <!-- method attribute is optional --> <tag name="doctrine.orm.entity_listener" event="preUpdate" entity="App\Entity\User" entity_manager="custom" method="validateEmail" /> </service> </services> </container>
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19

If you don't specify the method attribute, it falls back on the subscribed event name.

Starting with Doctrine bundle 1.12, if this method does not exist but if your entity listener is invokable, it falls back on the __invoke() method.

See also https://www.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#entity-listeners for more info on entity listeners and the resolver required by Symfony.

Lazy Entity Listeners

You can use the lazy attribute on the tag to make sure the listener services are only instantiated when they are actually used.

  • YAML
    1services: App\UserListener: tags: - { name: doctrine.orm.entity_listener, lazy: true }
    2
    3
    4
  • XML
    1<?xml version="1.0" ?> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <services> <service id="App\UserListener"> <tag name="doctrine.orm.entity_listener" event="preUpdate" entity="App\Entity\User" lazy="true" /> </service> </services> </container>
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11