[Mailer] Document require_tls option

For symfony#20644

Author: ssddanbrown

mailer.rst

@@ -416,6 +416,29 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
     the Internet, but it can be useful when both the application and the SMTP
     server are in a secured network, where there is no need for additional encryption.
 
+.. note::
+
+    This setting only works when the ``smtp://`` protocol is used.
+
+Require use of TLS
+~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.3
+
+    The option to require TLS was introduced in Symfony 7.3.
+
+You may want to ensure TLS is used, either directly or via ``STARTTLS``,
+for sending mail over SMTP regardless of other options set or SMTP server
+support. You can set TLS as required by calling ``setRequireTls(true)``
+on the ``EsmtpTransport`` instance, or by setting the ``require_tls`` option
+to ``true`` in the DSN::
+
+    $dsn = 'smtp://user:[email protected]?require_tls=true';
+
+When TLS is set as required, a :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`
+will be thrown if a TLS connection cannot be achieved during initial communications
+with the SMTP server.
+
 .. note::
 
     This setting only works when the ``smtp://`` protocol is used.