minor #17147 [Mailer] Document the mailer:test command (javiereguiluz)

javiereguiluz · javiereguiluz · commit f5ed38ca0fb2 · 2022-08-11T15:03:25.000+02:00
This PR was merged into the 6.2 branch. Discussion ---------- [Mailer] Document the mailer:test command Fixes #17054. Commits ------- 1f505a8 [Mailer] Document the mailer:test command
diff --git a/mailer.rst b/mailer.rst
@@ -1407,6 +1407,25 @@ Here's an example of making one available to download::
 Development & Debugging
 -----------------------
 
+Sending Test Emails
+~~~~~~~~~~~~~~~~~~~
+
+Symfony provides a command to send emails, which is useful during development
+to test if sending emails works correctly:
+
+.. code-block:: terminal
+
+    # the only mandatory argument is the recipient address
+    # (check the command help to learn about its options)
+    $ php bin/console mailer:test someone@example.com
+
+This command bypasses the :doc:`Messenger bus </messenger>`, if configured, to
+ease testing emails even when the Messenger consumer is not running.
+
+.. versionadded:: 6.2
+
+    The ``mailer:test`` command was introduced in Symfony 6.2.
+
 Disabling Delivery
 ~~~~~~~~~~~~~~~~~~
 
