Skip to content

Commit 2a3b7f6

Browse files
committed
minor #15504 [Mailer] Update section setting headers globally (ToshY)
This PR was submitted for the 5.3 branch but it was merged into the 5.4 branch instead. Discussion ---------- [Mailer] Update section setting headers globally **Description** Added caution to clarify that setting headers globally is not supported for every 3rd party provider / transport with keywords like "from" (e.g. [Mailjet API V3](https://dev.mailjet.com/email/guides/send-api-v31/#add-email-headers)). Commits ------- 1209923 Update section setting headers globally
2 parents 4b996e9 + 1209923 commit 2a3b7f6

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

mailer.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -605,6 +605,11 @@ and headers.
605605
.. versionadded:: 5.2
606606

607607
The ``headers`` option was introduced in Symfony 5.2.
608+
609+
.. caution::
610+
611+
The usage of keywords like ``from`` in the ``headers`` is not supported for every 3rd party provider (e.g. `Mailjet API V3`_).
612+
Please consult your provider's documentation before setting the ``headers`` globally.
608613

609614
Handling Sending Failures
610615
-------------------------
@@ -1496,3 +1501,4 @@ you can use the built in assertions::
14961501
.. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
14971502
.. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
14981503
.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
1504+
.. _`Mailjet API V3`: https://dev.mailjet.com/email/guides/send-api-v31/#add-email-headers

0 commit comments

Comments
 (0)