From b161bd80e40129dcdbeaf4e318d102ba122c7861 Mon Sep 17 00:00:00 2001 From: Romain Gautier Date: Fri, 17 Feb 2017 09:14:18 +0100 Subject: [PATCH 1/7] update swiftmailer reference --- reference/configuration/swiftmailer.rst | 42 +++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index 330ff291499..6f2e4cadaf3 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -18,11 +18,15 @@ a mailer. It is also possible to configure several mailers (see Configuration ------------- +* `url`_ * `transport`_ * `username`_ * `password`_ * `host`_ * `port`_ +* `timeout`_ +* `source_ip`_ +* `local_domain`_ * `encryption`_ * `auth_mode`_ * `spool`_ @@ -37,6 +41,15 @@ Configuration * `disable_delivery`_ * `logging`_ +url +~~~ + +**type**: ``string`` + +The URL to configure swift mailer. + +Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...`` + transport ~~~~~~~~~ @@ -79,6 +92,27 @@ port The port when using ``smtp`` as the transport. This defaults to 465 if encryption is ``ssl`` and 25 otherwise. +timeout +~~~~~~~ + +**type**: ``integer`` + +The timeout when using ``smtp`` as the transport + +source_ip +~~~~~~~~~ + +**type**: ``string`` + +The source IP when using ``smtp`` as the transport + +local_domain +~~~~~~~~~~~~ + +**type**: ``string`` + +The domain name to use in HELO command. + encryption ~~~~~~~~~~ @@ -191,6 +225,14 @@ logging If true, Symfony's data collector will be activated for Swift Mailer and the information will be available in the profiler. +.. tip:: + + The following configuration options are compatible with ``%env()%`` parameters: + ``url``, ``transport``, ``username``, ``password``, ``host``, + ``port``, ``timeout``, ``source_ip``, ``local_domain``, + ``encryption``, ``auth_mode``. + For details, see the :doc:`/configuration/external_parameters` article. + Full Default Configuration -------------------------- From 2bd1a22bcea8486a68e48d630f6642ba5f7c5f40 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Sun, 19 Feb 2017 11:07:00 +0100 Subject: [PATCH 2/7] Minor tweaks --- reference/configuration/swiftmailer.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index 6f2e4cadaf3..167cb692e33 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -46,7 +46,7 @@ url **type**: ``string`` -The URL to configure swift mailer. +The entire SwiftMailer configuration using a DSN-like URL format. Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...`` @@ -97,21 +97,21 @@ timeout **type**: ``integer`` -The timeout when using ``smtp`` as the transport +The timeout in seconds when using ``smtp`` as the transport. source_ip ~~~~~~~~~ **type**: ``string`` -The source IP when using ``smtp`` as the transport +The source IP address when using ``smtp`` as the transport. local_domain ~~~~~~~~~~~~ **type**: ``string`` -The domain name to use in HELO command. +The domain name to use in ``HELO`` command. encryption ~~~~~~~~~~ From 0e2853af2235798a62b528b059f127340df264c7 Mon Sep 17 00:00:00 2001 From: Romain Gautier Date: Thu, 23 Feb 2017 11:11:54 +0100 Subject: [PATCH 3/7] add mail transport as deprecated --- reference/configuration/swiftmailer.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index 167cb692e33..ff273119eed 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -59,7 +59,7 @@ The exact transport method to use to deliver emails. Valid values are: * smtp * gmail (see :doc:`/email/gmail`) -* mail +* mail (deprecated in SwiftMailer since version 5.4.5) * sendmail * null (same as setting `disable_delivery`_ to ``true``) From 333372376b6dc864120fd11539151b51d6fd1f79 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Mon, 13 Mar 2017 09:20:59 +0100 Subject: [PATCH 4/7] Added the missing "versionadded" directives --- reference/configuration/swiftmailer.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index ff273119eed..3731a2e9fe0 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -46,6 +46,9 @@ url **type**: ``string`` +.. versionadded:: 2.4.2 + The ``url`` option was added in SwiftMailerBundle 2.4.2. + The entire SwiftMailer configuration using a DSN-like URL format. Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...`` @@ -97,6 +100,9 @@ timeout **type**: ``integer`` +.. versionadded:: 2.4.2 + The ``url`` option was added in SwiftMailerBundle 2.4.2. + The timeout in seconds when using ``smtp`` as the transport. source_ip @@ -104,6 +110,9 @@ source_ip **type**: ``string`` +.. versionadded:: 2.4.2 + The ``url`` option was added in SwiftMailerBundle 2.4.2. + The source IP address when using ``smtp`` as the transport. local_domain @@ -111,6 +120,9 @@ local_domain **type**: ``string`` +.. versionadded:: 2.4.2 + The ``url`` option was added in SwiftMailerBundle 2.4.2. + The domain name to use in ``HELO`` command. encryption From 3395258923c39e12de66ccd7fff075202b6f1046 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Mon, 13 Mar 2017 10:50:06 +0100 Subject: [PATCH 5/7] Fixed ... again ... the versionadded directives --- reference/configuration/swiftmailer.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index 3731a2e9fe0..a7fb5991075 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -101,7 +101,7 @@ timeout **type**: ``integer`` .. versionadded:: 2.4.2 - The ``url`` option was added in SwiftMailerBundle 2.4.2. + The ``timeout`` option was added in SwiftMailerBundle 2.4.2. The timeout in seconds when using ``smtp`` as the transport. @@ -111,7 +111,7 @@ source_ip **type**: ``string`` .. versionadded:: 2.4.2 - The ``url`` option was added in SwiftMailerBundle 2.4.2. + The ``source_ip`` option was added in SwiftMailerBundle 2.4.2. The source IP address when using ``smtp`` as the transport. @@ -121,7 +121,7 @@ local_domain **type**: ``string`` .. versionadded:: 2.4.2 - The ``url`` option was added in SwiftMailerBundle 2.4.2. + The ``local_domain`` option was added in SwiftMailerBundle 2.4.2. The domain name to use in ``HELO`` command. From 8eaccef25406b80117aa40c22df594487b831499 Mon Sep 17 00:00:00 2001 From: Javier Eguiluz Date: Mon, 13 Mar 2017 11:31:34 +0100 Subject: [PATCH 6/7] Removed "encryption" and "auth_mode" from the list of %env()% compatible options --- reference/configuration/swiftmailer.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index a7fb5991075..fc6b0442613 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -239,10 +239,9 @@ the information will be available in the profiler. .. tip:: - The following configuration options are compatible with ``%env()%`` parameters: - ``url``, ``transport``, ``username``, ``password``, ``host``, - ``port``, ``timeout``, ``source_ip``, ``local_domain``, - ``encryption``, ``auth_mode``. + The following options can be set via environment variables using the + ``%env()%`` syntax: ``url``, ``transport``, ``username``, ``password``, + ``host``, ``port``, ``timeout``, ``source_ip``, ``local_domain``. For details, see the :doc:`/configuration/external_parameters` article. Full Default Configuration From 1c39991f4bea70fb7c594a14ebaa5cfd0b426bc7 Mon Sep 17 00:00:00 2001 From: Christian Flothmann Date: Sun, 30 Apr 2017 20:04:35 +0200 Subject: [PATCH 7/7] fix versionadded directives * The `url` option was added in version 2.3.10 of the SwiftmailerBundle (see symfony/swiftmailer-bundle#118). * The `timeout` and `source_ip` options are part of SwiftmailerBundle since symfony/swiftmailer-bundle#14 which was part of the 2.1.0 release. * The `local_domain` option was first included in the 2.4.0 release (see symfony/swiftmailer-bundle#141). --- reference/configuration/swiftmailer.rst | 13 ++----------- 1 file changed, 2 insertions(+), 11 deletions(-) diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst index fc6b0442613..53555680760 100644 --- a/reference/configuration/swiftmailer.rst +++ b/reference/configuration/swiftmailer.rst @@ -46,9 +46,6 @@ url **type**: ``string`` -.. versionadded:: 2.4.2 - The ``url`` option was added in SwiftMailerBundle 2.4.2. - The entire SwiftMailer configuration using a DSN-like URL format. Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...`` @@ -100,9 +97,6 @@ timeout **type**: ``integer`` -.. versionadded:: 2.4.2 - The ``timeout`` option was added in SwiftMailerBundle 2.4.2. - The timeout in seconds when using ``smtp`` as the transport. source_ip @@ -110,9 +104,6 @@ source_ip **type**: ``string`` -.. versionadded:: 2.4.2 - The ``source_ip`` option was added in SwiftMailerBundle 2.4.2. - The source IP address when using ``smtp`` as the transport. local_domain @@ -120,8 +111,8 @@ local_domain **type**: ``string`` -.. versionadded:: 2.4.2 - The ``local_domain`` option was added in SwiftMailerBundle 2.4.2. +.. versionadded:: 2.4.0 + The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0. The domain name to use in ``HELO`` command.