Merge remote-tracking branch 'origin/5.4' into 6.2

* origin/5.4:
  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
  Tweak
  [Validator] Fix a valid Date and Time constraint format
  fix plural rules
  Update event_dispatcher.rst
  Update upload_file.rst
  Update upload_file.rst
  Update upload_file.rst
  Update access_control.rst
  smaller example for env(resolve:FOO)
  Minor tweak
  Update environment processor page
  [Uid] Fix Uid config example
  [Workflow] MarkingStore: remove "arguments" and add "property"
  [SecurityBundle] Add doc for stateless firewall
  [Messenger] add `WorkerMessageRetriedEvent`
  Add Form is_empty_callback option

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

@@ -100,9 +100,9 @@ configure the behavior of the factory using configuration files::
             uid:
                 default_uuid_version: 6
                 name_based_uuid_version: 5
-                name_based_uuid_namespace: ~
+                name_based_uuid_namespace: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
                 time_based_uuid_version: 6
-                time_based_uuid_node: ~
+                time_based_uuid_node: 121212121212
 
     .. code-block:: xml
 
@@ -119,9 +119,9 @@ configure the behavior of the factory using configuration files::
                 <framework:uid
                     default_uuid_version="6"
                     name_based_uuid_version="5"
-                    name_based_uuid_namespace=""
+                    name_based_uuid_namespace="6ba7b810-9dad-11d1-80b4-00c04fd430c8"
                     time_based_uuid_version="6"
-                    time_based_uuid_node=""
+                    time_based_uuid_node="121212121212"
                 />
             </framework:config>
         </container>
@@ -141,9 +141,9 @@ configure the behavior of the factory using configuration files::
                 'uid' => [
                     'default_uuid_version' => 6,
                     'name_based_uuid_version' => 5,
-                    'name_based_uuid_namespace' => '',
+                    'name_based_uuid_namespace' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
                     'time_based_uuid_version' => 6,
-                    'time_based_uuid_node' => '',
+                    'time_based_uuid_node' => 121212121212,
                 ],
             ]);
         };

components/uid.rst

@@ -300,8 +300,7 @@ Symfony provides the following env var processors:
 
             # config/packages/sentry.yaml
             parameters:
-                env(HOST): '10.0.0.1'
-                sentry_host: '%env(HOST)%'
+                sentry_host: '10.0.0.1'
                 env(SENTRY_DSN): 'http://%sentry_host%/project'
             sentry:
                 dsn: '%env(resolve:SENTRY_DSN)%'
@@ -316,8 +315,7 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <parameters>
-                    <parameter key="env(HOST)">10.0.0.1</parameter>
-                    <parameter key="sentry_host">%env(HOST)%</parameter>
+                    <parameter key="sentry_host">10.0.0.1</parameter>
                     <parameter key="env(SENTRY_DSN)">http://%sentry_host%/project</parameter>
                 </parameters>
 
@@ -327,8 +325,7 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/sentry.php
-            $container->setParameter('env(HOST)', '10.0.0.1');
-            $container->setParameter('sentry_host', '%env(HOST)%');
+            $container->setParameter('sentry_host', '10.0.0.1');
             $container->setParameter('env(SENTRY_DSN)', 'http://%sentry_host%/project');
             $container->loadFromExtension('sentry', [
                 'dsn' => '%env(resolve:SENTRY_DSN)%',
@@ -441,7 +438,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(AUTH_FILE): '../config/auth.json'
+                env(AUTH_FILE): '%kernel.project_dir%/config/auth.json'
             google:
                 auth: '%env(file:AUTH_FILE)%'
 
@@ -482,7 +479,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(PHP_FILE): '../config/.runtime-evaluated.php'
+                env(PHP_FILE): '%kernel.project_dir%/config/.runtime-evaluated.php'
             app:
                 auth: '%env(require:PHP_FILE)%'
 
@@ -524,7 +521,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(AUTH_FILE): '../config/auth.json'
+                env(AUTH_FILE): '%kernel.project_dir%/config/auth.json'
             google:
                 auth: '%env(trim:file:AUTH_FILE)%'
 

configuration/env_var_processors.rst

@@ -27,12 +27,12 @@ add a PDF brochure for each product. To do so, add a new property called
         #[ORM\Column(type: 'string')]
         private $brochureFilename;
 
-        public function getBrochureFilename()
+        public function getBrochureFilename(): string
         {
             return $this->brochureFilename;
         }
 
-        public function setBrochureFilename($brochureFilename)
+        public function setBrochureFilename(string $brochureFilename)
         {
             $this->brochureFilename = $brochureFilename;
 
@@ -126,13 +126,14 @@ Finally, you need to update the code of the controller that handles the form::
     use Symfony\Component\HttpFoundation\File\Exception\FileException;
     use Symfony\Component\HttpFoundation\File\UploadedFile;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     use Symfony\Component\String\Slugger\SluggerInterface;
 
     class ProductController extends AbstractController
     {
         #[Route('/product/new', name: 'app_product_new')]
-        public function new(Request $request, SluggerInterface $slugger)
+        public function new(Request $request, SluggerInterface $slugger): Response
         {
             $product = new Product();
             $form = $this->createForm(ProductType::class, $product);
@@ -245,7 +246,7 @@ logic to a separate service::
         ) {
         }
 
-        public function upload(UploadedFile $file)
+        public function upload(UploadedFile $file): string
         {
             $originalFilename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME);
             $safeFilename = $this->slugger->slug($originalFilename);
@@ -260,7 +261,7 @@ logic to a separate service::
             return $fileName;
         }
 
-        public function getTargetDirectory()
+        public function getTargetDirectory(): string
         {
             return $this->targetDirectory;
         }

controller/upload_file.rst

@@ -255,7 +255,7 @@ listen to the same ``kernel.exception`` event::
 
     class ExceptionSubscriber implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             // return the subscribed events, their methods and priorities
             return [

event_dispatcher.rst

@@ -218,6 +218,17 @@ Infobip              infobip+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:[email protected]:25
+
 High Availability
 ~~~~~~~~~~~~~~~~~
 

mailer.rst

@@ -2475,12 +2475,13 @@ In addition to middleware, Messenger also dispatches several events. You can
 :doc:`create an event listener </event_dispatcher>` to hook into various parts
 of the process. For each, the event class is the event name:
 
-* :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
-* :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageReceivedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\SendMessageToTransportsEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageFailedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageHandledEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageReceivedEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerRunningEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStoppedEvent`
 
 Multiple Buses, Command & Event Buses