Merge branch '3.4'

* 3.4:
  [3.4] Remove useless docblocks
  [3.3] More docblock fixes
  [2.7] More docblock fixes
  [TwigBridge] Fix BC break due required twig environment
  Random fixes
  Docblock fixes
  [DI] Fix cannot bind env var
  Fix some signatures in PHP-DSLs
  [HttpKernel] Enhance deprecation message
  bumped Symfony version to 3.4.0
  updated VERSION for 3.4.0-BETA3
  updated CHANGELOG for 3.4.0-BETA3
  [SecurityBundle] Fix the datacollector to properly support decision.object being null

Author: nicolas-grekas

CacheWarmer/SerializerCacheWarmer.php

@@ -80,7 +80,7 @@ private function extractSupportedLoaders(array $loaders)
             if ($loader instanceof XmlFileLoader || $loader instanceof YamlFileLoader) {
                 $supportedLoaders[] = $loader;
             } elseif ($loader instanceof LoaderChain) {
-                $supportedLoaders = array_merge($supportedLoaders, $this->extractSupportedLoaders($loader->getDelegatedLoaders()));
+                $supportedLoaders = array_merge($supportedLoaders, $this->extractSupportedLoaders($loader->getLoaders()));
             }
         }
 

CacheWarmer/ValidatorCacheWarmer.php

@@ -91,7 +91,7 @@ private function extractSupportedLoaders(array $loaders)
             if ($loader instanceof XmlFileLoader || $loader instanceof YamlFileLoader) {
                 $supportedLoaders[] = $loader;
             } elseif ($loader instanceof LoaderChain) {
-                $supportedLoaders = array_merge($supportedLoaders, $this->extractSupportedLoaders($loader->getDelegatedLoaders()));
+                $supportedLoaders = array_merge($supportedLoaders, $this->extractSupportedLoaders($loader->getLoaders()));
             }
         }
 

Client.php

@@ -62,7 +62,7 @@ public function getKernel()
     /**
      * Gets the profile associated with the current Response.
      *
-     * @return HttpProfile A Profile instance
+     * @return HttpProfile|false A Profile instance
      */
     public function getProfile()
     {

Console/Descriptor/XmlDescriptor.php

@@ -409,8 +409,6 @@ private function getContainerDefinitionDocument(Definition $definition, $id = nu
     }
 
     /**
-     * @param array $arguments
-     *
      * @return \DOMNode[]
      */
     private function getArgumentNodes(array $arguments, \DOMDocument $dom)
@@ -521,10 +519,6 @@ private function getEventDispatcherListenersDocument(EventDispatcherInterface $e
         return $dom;
     }
 
-    /**
-     * @param \DOMElement $element
-     * @param array       $eventListeners
-     */
     private function appendEventListenerDocument(EventDispatcherInterface $eventDispatcher, $event, \DOMElement $element, array $eventListeners)
     {
         foreach ($eventListeners as $listener) {

Controller/Controller.php

@@ -32,6 +32,8 @@ abstract class Controller implements ContainerAwareInterface
      * @param string $name The parameter name
      *
      * @return mixed
+     *
+     * @final since version 3.4
      */
     protected function getParameter($name)
     {

Tests/Command/CachePruneCommandTest.php

@@ -97,9 +97,6 @@ private function getPruneableInterfaceMock()
     }
 
     /**
-     * @param KernelInterface     $kernel
-     * @param RewindableGenerator $generator
-     *
      * @return CommandTester
      */
     private function getCommandTester(KernelInterface $kernel, RewindableGenerator $generator)