Merge branch '7.4' into 8.0

* 7.4:
  [Messenger] Fix unreachable catch
  [DependencyInjection] Fix PHPDoc syntax for InstantiatorInterface
  [DomCrawler] Handle malformed tags in HTML5 parser
  [MonologBundle] Accept HttpExceptionInterface in HttpCodeActivationStrategy
  Add the proper type declarations for the messenger SerializerInterface
  [HttpKernel] Make Kernel::getShareDir() nullable

Author: nicolas-grekas

LazyProxy/Instantiator/InstantiatorInterface.php

@@ -25,8 +25,10 @@ interface InstantiatorInterface
     /**
      * Instantiates a proxy object.
      *
-     * @param string            $id               Identifier of the requested service
-     * @param callable(object=) $realInstantiator A callback that is capable of producing the real service instance
+     * @param string                                        $id               Identifier of the requested service
+     * @param (callable(): object)|(callable(object): void) $realInstantiator A callback that creates or initializes the real service instance:
+     *                                                                        - For direct instantiation or value-holder proxies: Called without arguments and returns the service object.
+     *                                                                        - For ghost object proxies (using PHP's lazy objects): Called with the proxy as argument, initializes it in place and returns void.
      */
     public function instantiateProxy(ContainerInterface $container, Definition $definition, string $id, callable $realInstantiator): object;
 }

LazyProxy/Instantiator/RealServiceInstantiator.php

@@ -21,6 +21,9 @@
  */
 class RealServiceInstantiator implements InstantiatorInterface
 {
+    /**
+     * @return object The real service instance
+     */
     public function instantiateProxy(ContainerInterface $container, Definition $definition, string $id, callable $realInstantiator): object
     {
         return $realInstantiator();