Skip to content

Commit 6dbd0bd

Browse files
javiereguiluzjaviereguiluz
committed
Merge branch '6.2' into 6.3
* 6.2: [Mailer] Improve DSN formats table [Mailer] Document the optional HttpClient dependency
2 parents 53f9d77 + 2e73d09 commit 6dbd0bd

File tree

1 file changed

+53
-15
lines changed

1 file changed

+53
-15
lines changed

‎mailer.rst‎

Lines changed: 53 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -169,21 +169,53 @@ transport, but you can force to use one:
169169
This table shows the full list of available DSN formats for each third
170170
party provider:
171171

172-
===================== ============================================ ========================================= ========================================
173-
Provider SMTP HTTP API
174-
===================== ============================================ ========================================= ========================================
175-
`Amazon SES`_ ses+smtp://USERNAME:PASSWORD@default ses+https://ACCESS_KEY:SECRET_KEY@default ses+api://ACCESS_KEY:SECRET_KEY@default
176-
`Google Gmail`_ gmail+smtp://USERNAME:APP-PASSWORD@default n/a n/a
177-
`Infobip`_ infobip+smtp://KEY@default n/a infobip+api://KEY@BASE_URL
178-
`Mailchimp Mandrill`_ mandrill+smtp://USERNAME:PASSWORD@default mandrill+https://KEY@default mandrill+api://KEY@default
179-
`MailerSend`_ mailersend+smtp://KEY@default n/a mailersend+api://KEY@BASE_URL
180-
`Mailgun`_ mailgun+smtp://USERNAME:PASSWORD@default mailgun+https://KEY:DOMAIN@default mailgun+api://KEY:DOMAIN@default
181-
`Mailjet`_ mailjet+smtp://ACCESS_KEY:SECRET_KEY@default n/a mailjet+api://ACCESS_KEY:SECRET_KEY@default
182-
`MailPace`_ mailpace+api://API_TOKEN@default n/a mailpace+api://API_TOKEN@default
183-
`Postmark`_ postmark+smtp://ID@default n/a postmark+api://KEY@default
184-
`Sendgrid`_ sendgrid+smtp://KEY@default n/a sendgrid+api://KEY@default
185-
`Sendinblue`_ sendinblue+smtp://USERNAME:PASSWORD@default n/a sendinblue+api://KEY@default
186-
===================== ============================================ ========================================= ========================================
172+
+------------------------+-----------------------------------------------------+
173+
| Provider | Formats |
174+
+========================+=====================================================+
175+
| `Amazon SES`_ | - SMTP ses+smtp://USERNAME:PASSWORD@default |
176+
| | - HTTP ses+https://ACCESS_KEY:SECRET_KEY@default |
177+
| | - API ses+api://ACCESS_KEY:SECRET_KEY@default |
178+
+------------------------+-----------------------------------------------------+
179+
| `Google Gmail`_ | - SMTP gmail+smtp://USERNAME:APP-PASSWORD@default |
180+
| | - HTTP n/a |
181+
| | - API n/a |
182+
+------------------------+-----------------------------------------------------+
183+
| `Infobip`_ | - SMTP infobip+smtp://KEY@default |
184+
| | - HTTP n/a |
185+
| | - API infobip+api://KEY@BASE_URL |
186+
+------------------------+-----------------------------------------------------+
187+
| `Mailchimp Mandrill`_ | - SMTP mandrill+smtp://USERNAME:PASSWORD@default |
188+
| | - HTTP mandrill+https://KEY@default |
189+
| | - API mandrill+api://KEY@default |
190+
+------------------------+-----------------------------------------------------+
191+
| `MailerSend`_ | - SMTP mailersend+smtp://KEY@default |
192+
| | - HTTP n/a |
193+
| | - API mailersend+api://KEY@BASE_URL |
194+
+------------------------+-----------------------------------------------------+
195+
| `Mailgun`_ | - SMTP mailgun+smtp://USERNAME:PASSWORD@default |
196+
| | - HTTP mailgun+https://KEY:DOMAIN@default |
197+
| | - API mailgun+api://KEY:DOMAIN@default |
198+
+------------------------+-----------------------------------------------------+
199+
| `Mailjet`_ | - SMTP mailjet+smtp://ACCESS_KEY:SECRET_KEY@default |
200+
| | - HTTP n/a |
201+
| | - API mailjet+api://ACCESS_KEY:SECRET_KEY@default |
202+
+------------------------+-----------------------------------------------------+
203+
| `MailPace`_ | - SMTP mailpace+api://API_TOKEN@default |
204+
| | - HTTP n/a |
205+
| | - API mailpace+api://API_TOKEN@default |
206+
+------------------------+-----------------------------------------------------+
207+
| `Postmark`_ | - SMTP postmark+smtp://ID@default |
208+
| | - HTTP n/a |
209+
| | - API postmark+api://KEY@default |
210+
+------------------------+-----------------------------------------------------+
211+
| `Sendgrid`_ | - SMTP sendgrid+smtp://KEY@default |
212+
| | - HTTP n/a |
213+
| | - API sendgrid+api://KEY@default |
214+
+------------------------+-----------------------------------------------------+
215+
| `Sendinblue`_ | - SMTP sendinblue+smtp://USERNAME:PASSWORD@default |
216+
| | - HTTP n/a |
217+
| | - API sendinblue+api://KEY@default |
218+
+------------------------+-----------------------------------------------------+
187219

188220
.. versionadded:: 6.3
189221

@@ -207,6 +239,12 @@ Provider SMTP HTTP
207239
When using SMTP, the default timeout for sending a message before throwing an
208240
exception is the value defined in the `default_socket_timeout`_ PHP.ini option.
209241

242+
.. note::
243+
244+
Besides SMTP, many 3rd party transports offer a web API to send emails.
245+
To do so, you have to install (additionally to the bridge)
246+
the HttpClient component via ``composer require symfony/http-client``.
247+
210248
.. note::
211249

212250
To use Google Gmail, you must have a Google Account with 2-Step-Verification (2FA)

0 commit comments

Comments
 (0)