Merge branch '4.4'

javiereguiluz · javiereguiluz · commit 5fa0688d974f · 2019-10-17T15:40:00.000+02:00
* 4.4:
  Documented the doctrine_clear_entity_manager middleware
diff --git a/messenger.rst b/messenger.rst
@@ -1375,6 +1375,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 -->
@@ -1400,6 +1405,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>
@@ -1418,12 +1425,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
 ~~~~~~~~~~~~~~~~
 
