Documented the doctrine_clear_entity_manager middleware

Author: javiereguiluz

messenger.rst

@@ -1403,6 +1403,11 @@ may want to use:
                             # or pass a different entity manager to any
                             #- doctrine_transaction: ['custom']
 
+                            # After handling, the clear() method is executed in the
+                            # entity manager, which reduces the memory consumption and
+                            # avoids side-effects related to unrefreshed entities
+                            - doctrine_clear_entity_manager
+
     .. code-block:: xml
 
         <!-- config/packages/messenger.xml -->
@@ -1428,6 +1433,8 @@ may want to use:
                             <framework:argument>custom</framework:argument>
                         </framework:middleware>
                         -->
+
+                        <framework:middleware id="doctrine_clear_entity_manager"/>
                     </framework:bus>
                 </framework:messenger>
             </framework:config>
@@ -1446,12 +1453,17 @@ may want to use:
                             'doctrine_close_connection',
                             // Using another entity manager
                             ['id' => 'doctrine_transaction', 'arguments' => ['custom']],
+                            'doctrine_clear_entity_manager',
                         ],
                     ],
                 ],
             ],
         ]);
 
+.. versionadded:: 4.4
+
+    The ``doctrine_clear_entity_manager`` middleware was introduced in Symfony 4.4.
+
 Messenger Events
 ~~~~~~~~~~~~~~~~