Merge branch '5.4' into 6.0

* 5.4:
  Add UrlHelper section to HttpFoundation docs
  Update handler_results.rst

Author: javiereguiluz

components/http_foundation.rst

@@ -757,6 +757,43 @@ The following example shows how to detect if the user agent prefers "safe" conte
         $response->setContentSafe();
 
         return $response;
+
+Generating Relative and Absolute URLs
+-------------------------------------
+
+.. versionadded:: 5.4
+
+    The feature to generate relative and absolute URLs was introduced in Symfony 5.4.
+
+Generating absolute and relative URLs for a given path is a common need
+in some applications. In Twig templates you can use the
+:ref:`absolute_url() <reference-twig-function-absolute-url>` and
+:ref:`relative_path() <reference-twig-function-relative-path>` functions to do that.
+
+The :class:`Symfony\\Component\\HttpFoundation\\UrlHelper` class provides the
+same functionality for PHP code via the ``getAbsoluteUrl()`` and ``getRelativePath()``
+methods. You can inject this as a service anywhere in your application::
+
+    // src/Normalizer/UserApiNormalizer.php
+    namespace App\Normalizer;
+
+    use Symfony\Component\HttpFoundation\UrlHelper;
+
+    class UserApiNormalizer
+    {
+        private UrlHelper $urlHelper;
+
+        public function __construct(UrlHelper $urlHelper)
+        {
+            $this->urlHelper = $urlHelper;
+        }
+
+        public function normalize($user)
+        {
+            return [
+                'avatar' => $this->urlHelper->getAbsoluteUrl($user->avatar()->path()),
+            ];
+        }
     }
 
 Learn More

messenger/handler_results.rst

@@ -11,7 +11,7 @@ You can use this to get the value returned by the handler(s)::
     use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Messenger\Stamp\HandledStamp;
 
-    $envelope = $messageBus->dispatch(SomeMessage());
+    $envelope = $messageBus->dispatch(new SomeMessage());
 
     // get the value that was returned by the last message handler
     $handledStamp = $envelope->last(HandledStamp::class);

reference/twig_reference.rst

@@ -225,6 +225,8 @@ Returns the absolute URL (with scheme and host) for the given route. If
     Read more about :doc:`Symfony routing </routing>` and about
     :ref:`creating links in Twig templates <templates-link-to-pages>`.
 
+.. _reference-twig-function-absolute-url:
+
 absolute_url
 ~~~~~~~~~~~~
 
@@ -239,6 +241,8 @@ Returns the absolute URL (with scheme and host) from the passed relative path. C
 :ref:`asset() function <reference-twig-function-asset>` to generate absolute URLs
 for web assets. Read more about :ref:`Linking to CSS, JavaScript and Image Assets <templates-link-to-assets>`.
 
+.. _reference-twig-function-relative-path:
+
 relative_path
 ~~~~~~~~~~~~~