@@ -12,7 +12,6 @@ integration, CSS inlining, file attachments and a lot more. Get them installed w
12
12
13
13
$ composer require symfony/mailer
14
14
15
-
16
15
.. _mailer-transport-setup :
17
16
18
17
Transport Setup
@@ -105,14 +104,13 @@ native ``native://default`` Mailer uses the sendmail
105
104
Using a 3rd Party Transport
106
105
~~~~~~~~~~~~~~~~~~~~~~~~~~~
107
106
108
- Instead of using your own SMTP server or sendmail binary, you can send emails via a 3rd party
109
- provider. Mailer supports several - install whichever you want :
107
+ Instead of using your own SMTP server or sendmail binary, you can send emails
108
+ via a 3rd party provider :
110
109
111
110
================== ==============================================
112
111
Service Install with
113
112
================== ==============================================
114
113
Amazon SES ``composer require symfony/amazon-mailer ``
115
- Gmail ``composer require symfony/google-mailer ``
116
114
MailChimp ``composer require symfony/mailchimp-mailer ``
117
115
Mailgun ``composer require symfony/mailgun-mailer ``
118
116
Mailjet ``composer require symfony/mailjet-mailer ``
@@ -122,6 +120,14 @@ Sendinblue ``composer require symfony/sendinblue-mailer``
122
120
OhMySMTP ``composer require symfony/oh-my-smtp-mailer ``
123
121
================== ==============================================
124
122
123
+ .. note ::
124
+
125
+ As a convenience, Symfony also provides support for Gmail (``composer
126
+ require symfony/google-mailer ``), but this should not be used in
127
+ production. In development, you should probably use an :ref: `email catcher
128
+ <mail-catcher>` instead. Note that most supported providers also provide a
129
+ free tier.
130
+
125
131
.. versionadded :: 5.2
126
132
127
133
The Sendinblue integration was introduced in Symfony 5.2.
@@ -1404,6 +1410,17 @@ is sent::
1404
1410
Development & Debugging
1405
1411
-----------------------
1406
1412
1413
+ .. _mail-catcher :
1414
+
1415
+ Enabling an Email Catcher
1416
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
1417
+
1418
+ When developing locally, it is recommended to use an email catcher. If you have
1419
+ enabled Docker support via Symfony recipes, an email catcher is automatically
1420
+ configured. In addition, if you are using the :doc: `Symfony local web server
1421
+ </setup/symfony_server>`, the mailer DSN is automatically exposed via the
1422
+ :ref: `symfony binary Docker integration <symfony-server-docker >`.
1423
+
1407
1424
Disabling Delivery
1408
1425
~~~~~~~~~~~~~~~~~~
1409
1426
0 commit comments