Merge branch '2.8' into 3.3

* 2.8: (22 commits)
  Tests and fix for issue in array model data in EntityType field with multiple=true
  [Form] Fixed PercentToLocalizedStringTransformer to accept both comma and dot as decimal separator, if possible
  removed useless PHPDoc
  [Form] Fix FormInterface::submit() annotation
  PdoSessionHandler: fix advisory lock for pgsql when session.sid_bits_per_character > 4
  HttpCache does not consider ESI resources in HEAD requests
  Fix translation for "This field was not expected"
  [Routing] Enhance Route(Collection) docblocks
  Added improvement for accuracy in MoneyToLocalizedStringTransformer.
  Removed unused private property
  Use correct verb form in the pull request template
  Use PHP_MAXPATHLEN in Filesystem.
  Added null as explicit return type (?TokenInterface)
  [FrameworkBundle] Fix Routing\DelegatingLoader
  Render all line breaks according to the exception message
  [Form] Fix phpdoc
  [DI] remove confusing code
  [Form] Fixed GroupSequence with "constraints" option
  [Validator] Clarify UUID validator behavior
  [Filesystem] Fixed makePathRelative
  ...

Author: nicolas-grekas

Authentication/AuthenticationProviderManager.php

@@ -35,8 +35,6 @@ class AuthenticationProviderManager implements AuthenticationManagerInterface
     private $eventDispatcher;
 
     /**
-     * Constructor.
-     *
      * @param iterable|AuthenticationProviderInterface[] $providers        An iterable with AuthenticationProviderInterface instances as values
      * @param bool                                       $eraseCredentials Whether to erase credentials after authentication or not
      *

Authentication/AuthenticationTrustResolver.php

@@ -24,8 +24,6 @@ class AuthenticationTrustResolver implements AuthenticationTrustResolverInterfac
     private $rememberMeClass;
 
     /**
-     * Constructor.
-     *
      * @param string $anonymousClass
      * @param string $rememberMeClass
      */

Authentication/Provider/AnonymousAuthenticationProvider.php

@@ -31,8 +31,6 @@ class AnonymousAuthenticationProvider implements AuthenticationProviderInterface
     private $secret;
 
     /**
-     * Constructor.
-     *
      * @param string $secret The secret shared with the AnonymousToken
      */
     public function __construct($secret)

Authentication/Provider/DaoAuthenticationProvider.php

@@ -32,8 +32,6 @@ class DaoAuthenticationProvider extends UserAuthenticationProvider
     private $userProvider;
 
     /**
-     * Constructor.
-     *
      * @param UserProviderInterface   $userProvider               An UserProviderInterface instance
      * @param UserCheckerInterface    $userChecker                An UserCheckerInterface instance
      * @param string                  $providerKey                The provider key

Authentication/Provider/LdapBindAuthenticationProvider.php

@@ -36,8 +36,6 @@ class LdapBindAuthenticationProvider extends UserAuthenticationProvider
     private $queryString;
 
     /**
-     * Constructor.
-     *
      * @param UserProviderInterface $userProvider               A UserProvider
      * @param UserCheckerInterface  $userChecker                A UserChecker
      * @param string                $providerKey                The provider key

Authentication/Provider/PreAuthenticatedAuthenticationProvider.php

@@ -34,8 +34,6 @@ class PreAuthenticatedAuthenticationProvider implements AuthenticationProviderIn
     private $providerKey;
 
     /**
-     * Constructor.
-     *
      * @param UserProviderInterface $userProvider An UserProviderInterface instance
      * @param UserCheckerInterface  $userChecker  An UserCheckerInterface instance
      * @param string                $providerKey  The provider key

Authentication/Provider/RememberMeAuthenticationProvider.php

@@ -23,8 +23,6 @@ class RememberMeAuthenticationProvider implements AuthenticationProviderInterfac
     private $providerKey;
 
     /**
-     * Constructor.
-     *
      * @param UserCheckerInterface $userChecker An UserCheckerInterface interface
      * @param string               $secret      A secret
      * @param string               $providerKey A provider secret

Authentication/Provider/UserAuthenticationProvider.php

@@ -33,8 +33,6 @@ abstract class UserAuthenticationProvider implements AuthenticationProviderInter
     private $providerKey;
 
     /**
-     * Constructor.
-     *
      * @param UserCheckerInterface $userChecker                An UserCheckerInterface interface
      * @param string               $providerKey                A provider key
      * @param bool                 $hideUserNotFoundExceptions Whether to hide user not found exception or not

Authentication/RememberMe/PersistentToken.php

@@ -25,8 +25,6 @@ final class PersistentToken implements PersistentTokenInterface
     private $lastUsed;
 
     /**
-     * Constructor.
-     *
      * @param string    $class
      * @param string    $username
      * @param string    $series

Authentication/Token/AbstractToken.php

@@ -31,8 +31,6 @@ abstract class AbstractToken implements TokenInterface
     private $attributes = array();
 
     /**
-     * Constructor.
-     *
      * @param (RoleInterface|string)[] $roles An array of roles
      *
      * @throws \InvalidArgumentException

Authentication/Token/AnonymousToken.php

@@ -23,8 +23,6 @@ class AnonymousToken extends AbstractToken
     private $secret;
 
     /**
-     * Constructor.
-     *
      * @param string        $secret A secret used to make sure the token is created by the app and not by a malicious client
      * @param string|object $user   The user can be a UserInterface instance, or an object implementing a __toString method or the username as a regular string
      * @param Role[]        $roles  An array of roles

Authentication/Token/PreAuthenticatedToken.php

@@ -22,8 +22,6 @@ class PreAuthenticatedToken extends AbstractToken
     private $providerKey;
 
     /**
-     * Constructor.
-     *
      * @param string|object            $user        The user can be a UserInterface instance, or an object implementing a __toString method or the username as a regular string
      * @param mixed                    $credentials The user credentials
      * @param string                   $providerKey The provider key

Authentication/Token/RememberMeToken.php

@@ -24,8 +24,6 @@ class RememberMeToken extends AbstractToken
     private $providerKey;
 
     /**
-     * Constructor.
-     *
      * @param UserInterface $user
      * @param string        $providerKey
      * @param string        $secret      A secret used to make sure the token is created by the app and not by a malicious client

Authentication/Token/UsernamePasswordToken.php

@@ -22,8 +22,6 @@ class UsernamePasswordToken extends AbstractToken
     private $providerKey;
 
     /**
-     * Constructor.
-     *
      * @param string|object            $user        The username (like a nickname, email address, etc.), or a UserInterface instance or an object implementing a __toString method
      * @param mixed                    $credentials This usually is the password of the user
      * @param string                   $providerKey The provider key

Authorization/AuthorizationChecker.php

@@ -31,8 +31,6 @@ class AuthorizationChecker implements AuthorizationCheckerInterface
     private $alwaysAuthenticate;
 
     /**
-     * Constructor.
-     *
      * @param TokenStorageInterface          $tokenStorage
      * @param AuthenticationManagerInterface $authenticationManager An AuthenticationManager instance
      * @param AccessDecisionManagerInterface $accessDecisionManager An AccessDecisionManager instance

Authorization/Voter/AuthenticatedVoter.php

@@ -32,8 +32,6 @@ class AuthenticatedVoter implements VoterInterface
     private $authenticationTrustResolver;
 
     /**
-     * Constructor.
-     *
      * @param AuthenticationTrustResolverInterface $authenticationTrustResolver
      */
     public function __construct(AuthenticationTrustResolverInterface $authenticationTrustResolver)

Authorization/Voter/ExpressionVoter.php

@@ -31,8 +31,6 @@ class ExpressionVoter implements VoterInterface
     private $roleHierarchy;
 
     /**
-     * Constructor.
-     *
      * @param ExpressionLanguage                   $expressionLanguage
      * @param AuthenticationTrustResolverInterface $trustResolver
      * @param RoleHierarchyInterface|null          $roleHierarchy

Authorization/Voter/RoleVoter.php

@@ -24,8 +24,6 @@ class RoleVoter implements VoterInterface
     private $prefix;
 
     /**
-     * Constructor.
-     *
      * @param string $prefix The role prefix
      */
     public function __construct($prefix = 'ROLE_')

Encoder/BCryptPasswordEncoder.php

@@ -27,8 +27,6 @@ class BCryptPasswordEncoder extends BasePasswordEncoder
     private $cost;
 
     /**
-     * Constructor.
-     *
      * @param int $cost The algorithmic cost that should be used
      *
      * @throws \RuntimeException         When no BCrypt encoder is available

Encoder/MessageDigestPasswordEncoder.php

@@ -25,8 +25,6 @@ class MessageDigestPasswordEncoder extends BasePasswordEncoder
     private $iterations;
 
     /**
-     * Constructor.
-     *
      * @param string $algorithm          The digest algorithm to use
      * @param bool   $encodeHashAsBase64 Whether to base64 encode the password hash
      * @param int    $iterations         The number of iterations to use to stretch the password hash

Encoder/Pbkdf2PasswordEncoder.php

@@ -34,8 +34,6 @@ class Pbkdf2PasswordEncoder extends BasePasswordEncoder
     private $length;
 
     /**
-     * Constructor.
-     *
      * @param string $algorithm          The digest algorithm to use
      * @param bool   $encodeHashAsBase64 Whether to base64 encode the password hash
      * @param int    $iterations         The number of iterations to use to stretch the password hash

Encoder/PlaintextPasswordEncoder.php

@@ -23,8 +23,6 @@ class PlaintextPasswordEncoder extends BasePasswordEncoder
     private $ignorePasswordCase;
 
     /**
-     * Constructor.
-     *
      * @param bool $ignorePasswordCase Compare password case-insensitive
      */
     public function __construct($ignorePasswordCase = false)

Role/Role.php

@@ -21,8 +21,6 @@ class Role implements RoleInterface
     private $role;
 
     /**
-     * Constructor.
-     *
      * @param string $role The role name
      */
     public function __construct($role)

Role/RoleHierarchy.php

@@ -22,8 +22,6 @@ class RoleHierarchy implements RoleHierarchyInterface
     protected $map;
 
     /**
-     * Constructor.
-     *
      * @param array $hierarchy An array defining the hierarchy
      */
     public function __construct(array $hierarchy)

Role/SwitchUserRole.php

@@ -24,8 +24,6 @@ class SwitchUserRole extends Role
     private $source;
 
     /**
-     * Constructor.
-     *
      * @param string         $role   The role as a string
      * @param TokenInterface $source The original token
      */

User/InMemoryUserProvider.php

@@ -27,8 +27,6 @@ class InMemoryUserProvider implements UserProviderInterface
     private $users;
 
     /**
-     * Constructor.
-     *
      * The user array is a hash where the keys are usernames and the values are
      * an array of attributes: 'password', 'enabled', and 'roles'.
      *