From 97d301a5c1c4a69f3958777b95d9c8ffcd4b928b Mon Sep 17 00:00:00 2001
From: Pierre Ambroise <pierre27.ambroise@gmail.com>
Date: Wed, 2 Apr 2025 11:41:05 +0200
Subject: [PATCH] [Messenger] Document stamps in HandleTrait::handle

---
 messenger.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index fc8f9491022..159dd567a34 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2512,6 +2512,20 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
         }
     }
 
+You also can also add stamps when handling a message. For example, you can
+add an ``DoctrineFlushStamp`` to flush the entity manager after handling the message::
+
+    $this->handle(new SomeMessage($data), [new DoctrineFlushStamp()]);
+
+.. note::
+
+    If adding a stamp of the same type that already exists in the envelope,
+    both stamps will be kept (see `Envelopes & Stamps`_).
+
+.. versionadded:: 7.3
+
+    The ``$stamps`` parameter on the handle method was introduced in Symfony 7.3.
+
 Customizing Handlers
 --------------------