Updated the main email article to Symfony 4/Flex #8652
Conversation
email.rst
Outdated
| the power of the `Swift Mailer`_ library. This bundle comes with the Symfony | ||
| Standard Edition. | ||
| Sending emails is a common task for any web application and one that has | ||
| special complications and potential pitfalls. Symfony provides a mailer feature |
There was a problem hiding this comment.
I think the first sentence is crap... and it's not your change - I think the old sentence (I probably wrote it?) is crap. Let's remove it entirely.
email.rst
Outdated
|
|
||
| .. code-block:: xml | ||
| If your application doesn't use Symfony Flex, follow the installation | ||
| instructions of the `SwiftMailerBundle`_. |
There was a problem hiding this comment.
instructions on SwiftMailerBundle...
email.rst
Outdated
| These values (e.g. ``%mailer_transport%``), are reading from the parameters | ||
| that are set in the :ref:`parameters.yml <config-parameters.yml>` file. You | ||
| can modify the values in that file, or set the values directly here. | ||
| The ``config/packages/swiftmailer.yaml`` file created when installing the mailer |
email.rst
Outdated
| that are set in the :ref:`parameters.yml <config-parameters.yml>` file. You | ||
| can modify the values in that file, or set the values directly here. | ||
| The ``config/packages/swiftmailer.yaml`` file created when installing the mailer | ||
| provides all the initial config needed to make it work, except the parameters |
There was a problem hiding this comment.
... needed to send emails, except your mail server connection details.
email.rst
Outdated
| * ``encryption`` (``tls``, or ``ssl``) | ||
| * ``auth_mode`` (``plain``, ``login``, or ``cram-md5``) | ||
| * ``spool`` | ||
| # use this to disable the email delivery |
There was a problem hiding this comment.
... to disable email delivery
| * ``delivery_addresses`` (an array of email addresses where to send ALL emails) | ||
| * ``disable_delivery`` (set to true to disable delivery completely) | ||
| # use this to send emails via Gmail (don't use this in production) | ||
| MAILER_URL=gmail://username:password@localhost |
There was a problem hiding this comment.
Can we / should we delete the gmail.rst article now?
There was a problem hiding this comment.
Yes! I'm proposing to remove two email articles: #8668.
| Starting from SwiftMailer 5.4.5, the ``mail`` transport is deprecated | ||
| and will be removed in version 6. Consider using another transport like | ||
| ``smtp``, ``sendmail`` or ``gmail``. | ||
| Refer to the :doc:`SwiftMailer configuration reference </reference/configuration/swiftmailer>` |
There was a problem hiding this comment.
Is there an easy example we could show for Mandrill, SendGrid or Amazon SES? I believe you basically use smtp, but point to their servers. But that might not obvious without an example.
And if we show that here, could we delete cloud.rst?
There was a problem hiding this comment.
Yes, let's do that when we remove the other articles.
|
Status: Needs Work |
…guiluz) This PR was squashed before being merged into the master branch (closes #8652). Discussion ---------- Updated the main email article to Symfony 4/Flex Commits ------- 9e10577 Changes after Ryan's review (thanks!) 1732ccc Fixed a RST reference 5708a75 Updated the main email article to Symfony 4/Flex
No description provided.