From e1da71c4d09074dd9eb77fdfdd3c151a66f99057 Mon Sep 17 00:00:00 2001 From: Nik Spijkerman Date: Sun, 14 Jun 2020 15:07:30 +1200 Subject: [PATCH] Added a caution about encoding DSN credentials --- components/mailer.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/components/mailer.rst b/components/mailer.rst index f4290bed825..17dba79643c 100644 --- a/components/mailer.rst +++ b/components/mailer.rst @@ -102,6 +102,11 @@ For third-party providers, refer to the following table: Sendgrid sendgrid+smtp://apikey:KEY@default n/a sendgrid+api://KEY@default ==================== ========================================== =========================================== ======================================== +.. caution:: + + If your credentials contain special characters, they must be provided to the DSN in URL encoded form. + e.g. The DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default`` + Instead of choosing a specific protocol, you can also let Symfony pick the best one by omitting it from the scheme: for instance, ``mailgun://KEY:DOMAIN@default`` is equivalent to ``mailgun+https://KEY:DOMAIN@default``.