From 52bc2b9653ff98713dd851f7f9ca8d80de5b7aef Mon Sep 17 00:00:00 2001 From: Thomas Landauer Date: Mon, 25 Feb 2019 18:01:05 +0100 Subject: [PATCH] Update email.rst Copied caution-box about special characters from https://symfony.com/doc/current/doctrine.html#configuring-the-database --- email.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/email.rst b/email.rst index f588eee0993..3db3b074262 100644 --- a/email.rst +++ b/email.rst @@ -39,11 +39,16 @@ environment variable in the ``.env`` file: # use this to disable email delivery MAILER_URL=null://localhost - # use this to configure a traditional SMTP server (make sure to URL-encode the - # values of the username and password if they contain non-alphanumeric characters - # such as '+', '@', ':' and '*', which are reserved in URLs) + # use this to configure a traditional SMTP server MAILER_URL=smtp://localhost:25?encryption=ssl&auth_mode=login&username=&password= +.. caution:: + + If the username, password or host contain any character considered special in a + URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must + encode them. See `RFC 3986`_ for the full list of reserved characters or use the + :phpfunction:`urlencode` function to encode them. + Refer to the :doc:`SwiftMailer configuration reference ` for the detailed explanation of all the available config options.