[Mailer] Add support for multiple mailers

hiddewie · javiereguiluz · commit aeedbd22c2fe · 2019-10-06T11:06:42.000+02:00
diff --git a/mailer.rst b/mailer.rst
@@ -697,6 +697,38 @@ you have a transport called ``async``, you can route the message there:
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
 
+Mutliple email transports
+-------------------------
+
+.. versionadded:: 4.4
+
+    The option to define multiple email transports was introduced in Symfony 4.4.
+
+You may want to use more than one mailer transport for delivery of your messages.
+This can be configured by replacing the ``dsn`` configuration entry with a
+``transports`` entry, like:
+
+.. code-block:: yaml
+
+    # config/packages/mailer.yaml
+    framework:
+        mailer:
+            transports:
+                main: '%env(MAILER_DSN)%'
+                important: '%env(MAILER_DSN_IMPORTANT)%'
+
+By default the first transport is used. The other tranports can be used by adding
+a text header ``X-Transport`` to an email:
+
+.. code-block:: php
+
+    // Send using first "main" transport ...
+    $mailer->send($email);
+
+    // ... or use the "important" one
+    $email->getHeaders()->addTextHeader('X-Transport', 'important');
+    $mailer->send($email);
+
 Development & Debugging
 -----------------------
 
