Merge branch '6.2' into 6.3

* 6.2:
  feature #17513 [Security] Use expression for `#[IsGranted()]` subject (HypeMC)
  minor #18114 update default value for framework.ide (GromNaN)
  minor #18018 [Messenger] add `WorkerRateLimitedEvent` (MrYamous)
  minor #18081 Update events.rst (hbgamra)
  minor #18091 [Doctrine] replace ManagerRegistry in doctrine associations doc (MrYamous)
  minor #18029 [HtmlSanitizer] Fix API usage on PHP config files (alexandre-daubois)
  Move Notifier bridges doc to the code repo README files
  Add note about custom port configuration being ignored by specific mailer transport DSN
  [Notifier] Add link to readme bridges

Author: weaverryan

_build/composer.json

@@ -17,6 +17,6 @@
         "php": ">=8.1",
         "symfony/console": "^6.2",
         "symfony/process": "^6.2",
-        "symfony-tools/docs-builder": "^0.18"
+        "symfony-tools/docs-builder": "^0.20"
     }
 }

_build/composer.lock

@@ -228,6 +228,17 @@ MailerSend           mailersend+smtp://KEY@default                        n/a
 
     Note that the protocol is *always* HTTPs and cannot be changed.
 
+.. note::
+
+    The specific transports, e.g. ``mailgun+smtp`` are designed to work without any manual configuration.
+    Changing the port by appending it to your DSN is not supported for any of these ``<provider>+smtp` transports.
+    If you need to change the port, use the ``smtp`` transport instead, like so:
+
+    .. code-block:: env
+
+        # .env
+        MAILER_DSN=smtp://KEY:DOMAIN@smtp.eu.mailgun.org.com:25
+
 High Availability
 ~~~~~~~~~~~~~~~~~