From 9ac7d0a2f6aa250c81e4f89cb31d53d99b97e750 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sun, 27 Nov 2022 17:42:25 +0100
Subject: [PATCH 1/2] Add documentation

---
 Resources/doc/event-listeners.rst | 103 ++++++++++++++++++++++++++++++
 Resources/doc/index.rst           |   1 +
 2 files changed, 104 insertions(+)
 create mode 100644 Resources/doc/event-listeners.rst

diff --git a/Resources/doc/event-listeners.rst b/Resources/doc/event-listeners.rst
new file mode 100644
index 000000000..fac6d0dc8
--- /dev/null
+++ b/Resources/doc/event-listeners.rst
@@ -0,0 +1,103 @@
+Event Listeners
+===============
+
+In opposite to :doc:`Entity Listeners </entity-listeners>`, Events listeners
+are services that listen for all entities in your application.
+
+See https://www.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#implementing-event-listeners
+for more info on events listeners.
+
+To register a service to act as an event listener you have to tag it with the
+``doctrine.event_listener`` tag:
+
+Starting with Doctrine bundle 2.8, you can use the ``AsEventListener``
+attribute to tag the service.
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/App/EventListener/SearchIndexer.php
+        namespace App\EventListener;
+
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEventListener;
+        use Doctrine\ORM\Event\LifecycleEventArgs;
+
+        #[AsEventListener('postPersist'/*, 500, 'default'*/)]
+        class SearchIndexer
+        {
+            public function postPersist(LifecycleEventArgs $event): void
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\EventListener\SearchIndexer:
+                tags:
+                    -
+                        name: 'doctrine.event_listener'
+                        # this is the only required option for the lifecycle listener tag
+                        event: 'postPersist'
+
+                        # listeners can define their priority in case multiple subscribers or listeners are associated
+                        # to the same event (default priority = 0; higher numbers = listener is run earlier)
+                        priority: 500
+
+                        # you can also restrict listeners to a specific Doctrine connection
+                        connection: 'default'
+
+    .. code-block:: xml
+
+        <!-- config/services.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
+            <services>
+                <!-- ... -->
+
+                <!--
+                    * 'event' is the only required option that defines the lifecycle listener
+                    * 'priority': used when multiple subscribers or listeners are associated to the same event
+                    *             (default priority = 0; higher numbers = listener is run earlier)
+                    * 'connection': restricts the listener to a specific Doctrine connection
+                -->
+                <service id="App\EventListener\SearchIndexer">
+                    <tag name="doctrine.event_listener"
+                        event="postPersist"
+                        priority="500"
+                        connection="default"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\EventListener\SearchIndexer;
+
+        return static function (ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            // listeners are applied by default to all Doctrine connections
+            $services->set(SearchIndexer::class)
+                ->tag('doctrine.event_listener', [
+                    // this is the only required option for the lifecycle listener tag
+                    'event' => 'postPersist',
+
+                    // listeners can define their priority in case multiple subscribers or listeners are associated
+                    // to the same event (default priority = 0; higher numbers = listener is run earlier)
+                    'priority' => 500,
+
+                    # you can also restrict listeners to a specific Doctrine connection
+                    'connection' => 'default',
+                ])
+            ;
+        };
diff --git a/Resources/doc/index.rst b/Resources/doc/index.rst
index 1bacaa60f..f4bc0c18d 100644
--- a/Resources/doc/index.rst
+++ b/Resources/doc/index.rst
@@ -8,5 +8,6 @@ configuration options, console commands and even a web debug toolbar collector.
 
     installation
     entity-listeners
+    event-listeners
     custom-id-generators
     configuration

From 4f845d8d60632524601a3bcca5b7ded6c638b1bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gabriel=20Ostroluck=C3=BD?= <gadelat@gmail.com>
Date: Fri, 30 Dec 2022 14:40:17 +0100
Subject: [PATCH 2/2] AsEventListener -> AsDoctrineListener

---
 Resources/doc/event-listeners.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/Resources/doc/event-listeners.rst b/Resources/doc/event-listeners.rst
index fac6d0dc8..eee99a6a3 100644
--- a/Resources/doc/event-listeners.rst
+++ b/Resources/doc/event-listeners.rst
@@ -1,16 +1,16 @@
 Event Listeners
 ===============
 
-In opposite to :doc:`Entity Listeners </entity-listeners>`, Events listeners
+In opposite to :doc:`Entity Listeners </entity-listeners>`, Event listeners
 are services that listen for all entities in your application.
 
 See https://www.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#implementing-event-listeners
-for more info on events listeners.
+for more info on event listeners.
 
 To register a service to act as an event listener you have to tag it with the
 ``doctrine.event_listener`` tag:
 
-Starting with Doctrine bundle 2.8, you can use the ``AsEventListener``
+Starting with Doctrine bundle 2.8, you can use the ``AsDoctrineListener``
 attribute to tag the service.
 
 .. configuration-block::
@@ -20,10 +20,10 @@ attribute to tag the service.
         // src/App/EventListener/SearchIndexer.php
         namespace App\EventListener;
 
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEventListener;
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
         use Doctrine\ORM\Event\LifecycleEventArgs;
 
-        #[AsEventListener('postPersist'/*, 500, 'default'*/)]
+        #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
         class SearchIndexer
         {
             public function postPersist(LifecycleEventArgs $event): void
@@ -96,7 +96,7 @@ attribute to tag the service.
                     // to the same event (default priority = 0; higher numbers = listener is run earlier)
                     'priority' => 500,
 
-                    # you can also restrict listeners to a specific Doctrine connection
+                    // you can also restrict listeners to a specific Doctrine connection
                     'connection' => 'default',
                 ])
             ;