From 7a44ed6544a3860c651391a68d06c4b4b35e5643 Mon Sep 17 00:00:00 2001 From: Fabien Potencier Date: Tue, 6 Aug 2019 07:23:17 +0200 Subject: [PATCH] removed unneeded phpdocs --- .../AbstractDoctrineExtension.php | 3 +-- .../FrameworkBundle/HttpCache/HttpCache.php | 8 +++---- .../Bundle/FrameworkBundle/Routing/Router.php | 8 ++----- .../Translation/Translator.php | 8 +++---- .../Bundle/TwigBundle/TemplateIterator.php | 7 +++---- .../WebProfilerExtension.php | 3 +-- .../Component/BrowserKit/CookieJar.php | 3 +-- .../Component/Console/Helper/ProgressBar.php | 3 +-- .../Console/Helper/QuestionHelper.php | 9 +++----- .../FatalErrorHandlerInterface.php | 3 +-- .../ExpressionLanguage/ParsedExpression.php | 4 ---- .../HttpFoundation/Session/Session.php | 5 ----- .../HttpKernel/Config/FileLocator.php | 5 ++--- .../EventListener/FragmentListener.php | 3 +-- .../EventListener/LocaleListener.php | 1 - .../EventListener/ProfilerListener.php | 7 ++----- .../EventListener/RouterListener.php | 7 +++---- .../AbstractSurrogateFragmentRenderer.php | 1 - .../Fragment/FragmentRendererInterface.php | 1 - .../Fragment/RoutableFragmentRenderer.php | 6 ++---- .../HttpKernel/HttpCache/HttpCache.php | 21 +++++++------------ .../HttpCache/SurrogateInterface.php | 7 +++---- .../Component/HttpKernel/HttpKernel.php | 13 +++++------- .../HttpKernel/HttpKernelInterface.php | 7 +++---- .../Ldap/Adapter/AbstractConnection.php | 5 ----- .../Routing/Loader/YamlFileLoader.php | 14 ++++++------- src/Symfony/Component/Routing/Router.php | 7 ++----- .../RememberMeAuthenticationProvider.php | 5 ++--- .../AccessDecisionManagerInterface.php | 5 ++--- .../Authorization/Voter/VoterInterface.php | 5 ++--- .../Firewall/GuardAuthenticationListener.php | 7 ++----- .../Component/Security/Http/AccessMap.php | 5 ++--- .../CustomAuthenticationFailureHandler.php | 3 +-- .../CustomAuthenticationSuccessHandler.php | 5 ++--- .../FormAuthenticationEntryPoint.php | 6 ++---- .../Security/Http/Firewall/LogoutListener.php | 7 ++----- .../Component/Security/Http/HttpUtils.php | 9 +++----- .../Normalizer/DenormalizerAwareTrait.php | 5 ----- .../Normalizer/NormalizerAwareTrait.php | 5 ----- .../Serializer/SerializerAwareTrait.php | 5 ----- .../Templating/Loader/CacheLoader.php | 3 +-- .../Component/Translation/Translator.php | 3 +-- .../VarDumper/Dumper/AbstractDumper.php | 1 - 43 files changed, 77 insertions(+), 171 deletions(-) diff --git a/src/Symfony/Bridge/Doctrine/DependencyInjection/AbstractDoctrineExtension.php b/src/Symfony/Bridge/Doctrine/DependencyInjection/AbstractDoctrineExtension.php index a36b55eb16..f6e6da99d5 100644 --- a/src/Symfony/Bridge/Doctrine/DependencyInjection/AbstractDoctrineExtension.php +++ b/src/Symfony/Bridge/Doctrine/DependencyInjection/AbstractDoctrineExtension.php @@ -35,8 +35,7 @@ abstract class AbstractDoctrineExtension extends Extension protected $drivers = []; /** - * @param array $objectManager A configured object manager - * @param ContainerBuilder $container A ContainerBuilder instance + * @param array $objectManager A configured object manager * * @throws \InvalidArgumentException */ diff --git a/src/Symfony/Bundle/FrameworkBundle/HttpCache/HttpCache.php b/src/Symfony/Bundle/FrameworkBundle/HttpCache/HttpCache.php index e4a630fb48..66a8cd466e 100644 --- a/src/Symfony/Bundle/FrameworkBundle/HttpCache/HttpCache.php +++ b/src/Symfony/Bundle/FrameworkBundle/HttpCache/HttpCache.php @@ -29,8 +29,7 @@ class HttpCache extends BaseHttpCache protected $kernel; /** - * @param KernelInterface $kernel A KernelInterface instance - * @param string $cacheDir The cache directory (default used if null) + * @param string $cacheDir The cache directory (default used if null) */ public function __construct(KernelInterface $kernel, string $cacheDir = null) { @@ -43,9 +42,8 @@ class HttpCache extends BaseHttpCache /** * Forwards the Request to the backend and returns the Response. * - * @param Request $request A Request instance - * @param bool $raw Whether to catch exceptions or not - * @param Response $entry A Response instance (the stale entry if present, null otherwise) + * @param bool $raw Whether to catch exceptions or not + * @param Response $entry A Response instance (the stale entry if present, null otherwise) * * @return Response A Response instance */ diff --git a/src/Symfony/Bundle/FrameworkBundle/Routing/Router.php b/src/Symfony/Bundle/FrameworkBundle/Routing/Router.php index bbb9f74ef7..a402d64ab0 100644 --- a/src/Symfony/Bundle/FrameworkBundle/Routing/Router.php +++ b/src/Symfony/Bundle/FrameworkBundle/Routing/Router.php @@ -36,12 +36,8 @@ class Router extends BaseRouter implements WarmableInterface, ServiceSubscriberI private $paramFetcher; /** - * @param ContainerInterface $container A ContainerInterface instance - * @param mixed $resource The main resource to load - * @param array $options An array of options - * @param RequestContext $context The context - * @param ContainerInterface|null $parameters A ContainerInterface instance allowing to fetch parameters - * @param LoggerInterface|null $logger + * @param mixed $resource The main resource to load + * @param array $options An array of options */ public function __construct(ContainerInterface $container, $resource, array $options = [], RequestContext $context = null, ContainerInterface $parameters = null, LoggerInterface $logger = null, string $defaultLocale = null) { diff --git a/src/Symfony/Bundle/FrameworkBundle/Translation/Translator.php b/src/Symfony/Bundle/FrameworkBundle/Translation/Translator.php index 1b2dc7e3fa..bfee2776f5 100644 --- a/src/Symfony/Bundle/FrameworkBundle/Translation/Translator.php +++ b/src/Symfony/Bundle/FrameworkBundle/Translation/Translator.php @@ -65,11 +65,9 @@ class Translator extends BaseTranslator implements WarmableInterface * * debug: Whether to enable debugging or not (false by default) * * resource_files: List of translation resources available grouped by locale. * - * @param ContainerInterface $container A ContainerInterface instance - * @param MessageFormatterInterface $formatter The message formatter - * @param string $defaultLocale - * @param array $loaderIds An array of loader Ids - * @param array $options An array of options + * @param string $defaultLocale + * @param array $loaderIds An array of loader Ids + * @param array $options An array of options * * @throws InvalidArgumentException */ diff --git a/src/Symfony/Bundle/TwigBundle/TemplateIterator.php b/src/Symfony/Bundle/TwigBundle/TemplateIterator.php index 3ad83ef818..4d4d835dfe 100644 --- a/src/Symfony/Bundle/TwigBundle/TemplateIterator.php +++ b/src/Symfony/Bundle/TwigBundle/TemplateIterator.php @@ -30,10 +30,9 @@ class TemplateIterator implements \IteratorAggregate private $defaultPath; /** - * @param KernelInterface $kernel A KernelInterface instance - * @param string $rootDir The directory where global templates can be stored - * @param array $paths Additional Twig paths to warm - * @param string|null $defaultPath The directory where global templates can be stored + * @param string $rootDir The directory where global templates can be stored + * @param array $paths Additional Twig paths to warm + * @param string|null $defaultPath The directory where global templates can be stored */ public function __construct(KernelInterface $kernel, string $rootDir, array $paths = [], string $defaultPath = null) { diff --git a/src/Symfony/Bundle/WebProfilerBundle/DependencyInjection/WebProfilerExtension.php b/src/Symfony/Bundle/WebProfilerBundle/DependencyInjection/WebProfilerExtension.php index 594e7fa3a7..4994a5f2ec 100644 --- a/src/Symfony/Bundle/WebProfilerBundle/DependencyInjection/WebProfilerExtension.php +++ b/src/Symfony/Bundle/WebProfilerBundle/DependencyInjection/WebProfilerExtension.php @@ -37,8 +37,7 @@ class WebProfilerExtension extends Extension /** * Loads the web profiler configuration. * - * @param array $configs An array of configuration settings - * @param ContainerBuilder $container A ContainerBuilder instance + * @param array $configs An array of configuration settings */ public function load(array $configs, ContainerBuilder $container) { diff --git a/src/Symfony/Component/BrowserKit/CookieJar.php b/src/Symfony/Component/BrowserKit/CookieJar.php index bce66197d3..76aeb680b3 100644 --- a/src/Symfony/Component/BrowserKit/CookieJar.php +++ b/src/Symfony/Component/BrowserKit/CookieJar.php @@ -140,8 +140,7 @@ class CookieJar /** * Updates the cookie jar from a Response object. * - * @param Response $response A Response object - * @param string $uri The base URL + * @param string $uri The base URL */ public function updateFromResponse(Response $response, $uri = null) { diff --git a/src/Symfony/Component/Console/Helper/ProgressBar.php b/src/Symfony/Component/Console/Helper/ProgressBar.php index 71e8af8d11..3751439fa3 100644 --- a/src/Symfony/Component/Console/Helper/ProgressBar.php +++ b/src/Symfony/Component/Console/Helper/ProgressBar.php @@ -52,8 +52,7 @@ final class ProgressBar private static $formats; /** - * @param OutputInterface $output An OutputInterface instance - * @param int $max Maximum steps (0 if unknown) + * @param int $max Maximum steps (0 if unknown) */ public function __construct(OutputInterface $output, int $max = 0, float $minSecondsBetweenRedraws = 0.1) { diff --git a/src/Symfony/Component/Console/Helper/QuestionHelper.php b/src/Symfony/Component/Console/Helper/QuestionHelper.php index c79b36fd9e..bf8ff5ad08 100644 --- a/src/Symfony/Component/Console/Helper/QuestionHelper.php +++ b/src/Symfony/Component/Console/Helper/QuestionHelper.php @@ -353,9 +353,8 @@ class QuestionHelper extends Helper /** * Gets a hidden response from user. * - * @param OutputInterface $output An Output instance - * @param resource $inputStream The handler resource - * @param bool $trimmable Is the answer trimmable + * @param resource $inputStream The handler resource + * @param bool $trimmable Is the answer trimmable * * @throws RuntimeException In case the fallback is deactivated and the response cannot be hidden */ @@ -416,9 +415,7 @@ class QuestionHelper extends Helper /** * Validates an attempt. * - * @param callable $interviewer A callable that will ask for a question and return the result - * @param OutputInterface $output An Output instance - * @param Question $question A Question instance + * @param callable $interviewer A callable that will ask for a question and return the result * * @return mixed The validated response * diff --git a/src/Symfony/Component/ErrorHandler/FatalErrorHandler/FatalErrorHandlerInterface.php b/src/Symfony/Component/ErrorHandler/FatalErrorHandler/FatalErrorHandlerInterface.php index afa8b7d236..daf5dcd1fd 100644 --- a/src/Symfony/Component/ErrorHandler/FatalErrorHandler/FatalErrorHandlerInterface.php +++ b/src/Symfony/Component/ErrorHandler/FatalErrorHandler/FatalErrorHandlerInterface.php @@ -23,8 +23,7 @@ interface FatalErrorHandlerInterface /** * Attempts to convert an error into an exception. * - * @param array $error An array as returned by error_get_last() - * @param FatalErrorException $exception A FatalErrorException instance + * @param array $error An array as returned by error_get_last() * * @return FatalErrorException|null A FatalErrorException instance if the class is able to convert the error, null otherwise */ diff --git a/src/Symfony/Component/ExpressionLanguage/ParsedExpression.php b/src/Symfony/Component/ExpressionLanguage/ParsedExpression.php index 2e2bf374e3..1416db1784 100644 --- a/src/Symfony/Component/ExpressionLanguage/ParsedExpression.php +++ b/src/Symfony/Component/ExpressionLanguage/ParsedExpression.php @@ -22,10 +22,6 @@ class ParsedExpression extends Expression { private $nodes; - /** - * @param string $expression An expression - * @param Node $nodes A Node representing the expression - */ public function __construct(string $expression, Node $nodes) { parent::__construct($expression); diff --git a/src/Symfony/Component/HttpFoundation/Session/Session.php b/src/Symfony/Component/HttpFoundation/Session/Session.php index db0b9aeb0b..3e0e0f6da2 100644 --- a/src/Symfony/Component/HttpFoundation/Session/Session.php +++ b/src/Symfony/Component/HttpFoundation/Session/Session.php @@ -31,11 +31,6 @@ class Session implements SessionInterface, \IteratorAggregate, \Countable private $data = []; private $usageIndex = 0; - /** - * @param SessionStorageInterface $storage A SessionStorageInterface instance - * @param AttributeBagInterface $attributes An AttributeBagInterface instance, (defaults null for default AttributeBag) - * @param FlashBagInterface $flashes A FlashBagInterface instance (defaults null for default FlashBag) - */ public function __construct(SessionStorageInterface $storage = null, AttributeBagInterface $attributes = null, FlashBagInterface $flashes = null) { $this->storage = $storage ?: new NativeSessionStorage(); diff --git a/src/Symfony/Component/HttpKernel/Config/FileLocator.php b/src/Symfony/Component/HttpKernel/Config/FileLocator.php index f88d1684fe..0d9652ac14 100644 --- a/src/Symfony/Component/HttpKernel/Config/FileLocator.php +++ b/src/Symfony/Component/HttpKernel/Config/FileLocator.php @@ -25,9 +25,8 @@ class FileLocator extends BaseFileLocator private $path; /** - * @param KernelInterface $kernel A KernelInterface instance - * @param string|null $path The path the global resource directory - * @param array $paths An array of paths where to look for resources + * @param string|null $path The path the global resource directory + * @param array $paths An array of paths where to look for resources */ public function __construct(KernelInterface $kernel, string $path = null, array $paths = []) { diff --git a/src/Symfony/Component/HttpKernel/EventListener/FragmentListener.php b/src/Symfony/Component/HttpKernel/EventListener/FragmentListener.php index f7d3dc6956..5ae61daaae 100644 --- a/src/Symfony/Component/HttpKernel/EventListener/FragmentListener.php +++ b/src/Symfony/Component/HttpKernel/EventListener/FragmentListener.php @@ -37,8 +37,7 @@ class FragmentListener implements EventSubscriberInterface private $fragmentPath; /** - * @param UriSigner $signer A UriSigner instance - * @param string $fragmentPath The path that triggers this listener + * @param string $fragmentPath The path that triggers this listener */ public function __construct(UriSigner $signer, string $fragmentPath = '/_fragment') { diff --git a/src/Symfony/Component/HttpKernel/EventListener/LocaleListener.php b/src/Symfony/Component/HttpKernel/EventListener/LocaleListener.php index cb8a194d49..aadc7b4b3d 100644 --- a/src/Symfony/Component/HttpKernel/EventListener/LocaleListener.php +++ b/src/Symfony/Component/HttpKernel/EventListener/LocaleListener.php @@ -34,7 +34,6 @@ class LocaleListener implements EventSubscriberInterface private $requestStack; /** - * @param RequestStack $requestStack A RequestStack instance * @param string $defaultLocale The default locale * @param RequestContextAwareInterface|null $router The router */ diff --git a/src/Symfony/Component/HttpKernel/EventListener/ProfilerListener.php b/src/Symfony/Component/HttpKernel/EventListener/ProfilerListener.php index 85a0aacb61..f9db55211e 100644 --- a/src/Symfony/Component/HttpKernel/EventListener/ProfilerListener.php +++ b/src/Symfony/Component/HttpKernel/EventListener/ProfilerListener.php @@ -39,11 +39,8 @@ class ProfilerListener implements EventSubscriberInterface protected $parents; /** - * @param Profiler $profiler A Profiler instance - * @param RequestStack $requestStack A RequestStack instance - * @param RequestMatcherInterface|null $matcher A RequestMatcher instance - * @param bool $onlyException True if the profiler only collects data when an exception occurs, false otherwise - * @param bool $onlyMasterRequests True if the profiler only collects data when the request is a master request, false otherwise + * @param bool $onlyException True if the profiler only collects data when an exception occurs, false otherwise + * @param bool $onlyMasterRequests True if the profiler only collects data when the request is a master request, false otherwise */ public function __construct(Profiler $profiler, RequestStack $requestStack, RequestMatcherInterface $matcher = null, bool $onlyException = false, bool $onlyMasterRequests = false) { diff --git a/src/Symfony/Component/HttpKernel/EventListener/RouterListener.php b/src/Symfony/Component/HttpKernel/EventListener/RouterListener.php index 01a95ebffb..4e8f2d1ff8 100644 --- a/src/Symfony/Component/HttpKernel/EventListener/RouterListener.php +++ b/src/Symfony/Component/HttpKernel/EventListener/RouterListener.php @@ -50,10 +50,9 @@ class RouterListener implements EventSubscriberInterface private $debug; /** - * @param UrlMatcherInterface|RequestMatcherInterface $matcher The Url or Request matcher - * @param RequestStack $requestStack A RequestStack instance - * @param RequestContext|null $context The RequestContext (can be null when $matcher implements RequestContextAwareInterface) - * @param LoggerInterface|null $logger The logger + * @param UrlMatcherInterface|RequestMatcherInterface $matcher The Url or Request matcher + * @param RequestContext|null $context The RequestContext (can be null when $matcher implements RequestContextAwareInterface) + * @param LoggerInterface|null $logger The logger * @param string $projectDir * @param bool $debug * diff --git a/src/Symfony/Component/HttpKernel/Fragment/AbstractSurrogateFragmentRenderer.php b/src/Symfony/Component/HttpKernel/Fragment/AbstractSurrogateFragmentRenderer.php index c337f50d53..adb1ec8227 100644 --- a/src/Symfony/Component/HttpKernel/Fragment/AbstractSurrogateFragmentRenderer.php +++ b/src/Symfony/Component/HttpKernel/Fragment/AbstractSurrogateFragmentRenderer.php @@ -32,7 +32,6 @@ abstract class AbstractSurrogateFragmentRenderer extends RoutableFragmentRendere * The "fallback" strategy when surrogate is not available should always be an * instance of InlineFragmentRenderer. * - * @param SurrogateInterface $surrogate An Surrogate instance * @param FragmentRendererInterface $inlineStrategy The inline strategy to use when the surrogate is not supported * @param UriSigner $signer */ diff --git a/src/Symfony/Component/HttpKernel/Fragment/FragmentRendererInterface.php b/src/Symfony/Component/HttpKernel/Fragment/FragmentRendererInterface.php index 8e454a01a6..00ad3c3f86 100644 --- a/src/Symfony/Component/HttpKernel/Fragment/FragmentRendererInterface.php +++ b/src/Symfony/Component/HttpKernel/Fragment/FragmentRendererInterface.php @@ -26,7 +26,6 @@ interface FragmentRendererInterface * Renders a URI and returns the Response content. * * @param string|ControllerReference $uri A URI as a string or a ControllerReference instance - * @param Request $request A Request instance * @param array $options An array of options * * @return Response A Response instance diff --git a/src/Symfony/Component/HttpKernel/Fragment/RoutableFragmentRenderer.php b/src/Symfony/Component/HttpKernel/Fragment/RoutableFragmentRenderer.php index c450f73b67..bd8f85b19a 100644 --- a/src/Symfony/Component/HttpKernel/Fragment/RoutableFragmentRenderer.php +++ b/src/Symfony/Component/HttpKernel/Fragment/RoutableFragmentRenderer.php @@ -39,10 +39,8 @@ abstract class RoutableFragmentRenderer implements FragmentRendererInterface /** * Generates a fragment URI for a given controller. * - * @param ControllerReference $reference A ControllerReference instance - * @param Request $request A Request instance - * @param bool $absolute Whether to generate an absolute URL or not - * @param bool $strict Whether to allow non-scalar attributes or not + * @param bool $absolute Whether to generate an absolute URL or not + * @param bool $strict Whether to allow non-scalar attributes or not * * @return string A fragment URI */ diff --git a/src/Symfony/Component/HttpKernel/HttpCache/HttpCache.php b/src/Symfony/Component/HttpKernel/HttpCache/HttpCache.php index eb128b0521..b310b5e548 100644 --- a/src/Symfony/Component/HttpKernel/HttpCache/HttpCache.php +++ b/src/Symfony/Component/HttpKernel/HttpCache/HttpCache.php @@ -256,8 +256,7 @@ class HttpCache implements HttpKernelInterface, TerminableInterface /** * Forwards the Request to the backend without storing the Response in the cache. * - * @param Request $request A Request instance - * @param bool $catch Whether to process exceptions + * @param bool $catch Whether to process exceptions * * @return Response A Response instance */ @@ -271,8 +270,7 @@ class HttpCache implements HttpKernelInterface, TerminableInterface /** * Invalidates non-safe methods (like POST, PUT, and DELETE). * - * @param Request $request A Request instance - * @param bool $catch Whether to process exceptions + * @param bool $catch Whether to process exceptions * * @return Response A Response instance * @@ -320,8 +318,7 @@ class HttpCache implements HttpKernelInterface, TerminableInterface * the backend using conditional GET. When no matching cache entry is found, * it triggers "miss" processing. * - * @param Request $request A Request instance - * @param bool $catch Whether to process exceptions + * @param bool $catch Whether to process exceptions * * @return Response A Response instance * @@ -366,9 +363,7 @@ class HttpCache implements HttpKernelInterface, TerminableInterface * The original request is used as a template for a conditional * GET request with the backend. * - * @param Request $request A Request instance - * @param Response $entry A Response instance to validate - * @param bool $catch Whether to process exceptions + * @param bool $catch Whether to process exceptions * * @return Response A Response instance */ @@ -429,8 +424,7 @@ class HttpCache implements HttpKernelInterface, TerminableInterface * Unconditionally fetches a fresh response from the backend and * stores it in the cache if is cacheable. * - * @param Request $request A Request instance - * @param bool $catch Whether to process exceptions + * @param bool $catch Whether to process exceptions * * @return Response A Response instance */ @@ -462,9 +456,8 @@ class HttpCache implements HttpKernelInterface, TerminableInterface * All backend requests (cache passes, fetches, cache validations) * run through this method. * - * @param Request $request A Request instance - * @param bool $catch Whether to catch exceptions or not - * @param Response $entry A Response instance (the stale entry if present, null otherwise) + * @param bool $catch Whether to catch exceptions or not + * @param Response $entry A Response instance (the stale entry if present, null otherwise) * * @return Response A Response instance */ diff --git a/src/Symfony/Component/HttpKernel/HttpCache/SurrogateInterface.php b/src/Symfony/Component/HttpKernel/HttpCache/SurrogateInterface.php index 85391f8f36..a26698c911 100644 --- a/src/Symfony/Component/HttpKernel/HttpCache/SurrogateInterface.php +++ b/src/Symfony/Component/HttpKernel/HttpCache/SurrogateInterface.php @@ -78,10 +78,9 @@ interface SurrogateInterface /** * Handles a Surrogate from the cache. * - * @param HttpCache $cache An HttpCache instance - * @param string $uri The main URI - * @param string $alt An alternative URI - * @param bool $ignoreErrors Whether to ignore errors or not + * @param string $uri The main URI + * @param string $alt An alternative URI + * @param bool $ignoreErrors Whether to ignore errors or not * * @return string * diff --git a/src/Symfony/Component/HttpKernel/HttpKernel.php b/src/Symfony/Component/HttpKernel/HttpKernel.php index 64e931f2bd..2f785c4624 100644 --- a/src/Symfony/Component/HttpKernel/HttpKernel.php +++ b/src/Symfony/Component/HttpKernel/HttpKernel.php @@ -110,8 +110,7 @@ class HttpKernel implements HttpKernelInterface, TerminableInterface * * Exceptions are not caught. * - * @param Request $request A Request instance - * @param int $type The type of the request (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) + * @param int $type The type of the request (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) * * @return Response A Response instance * @@ -175,9 +174,8 @@ class HttpKernel implements HttpKernelInterface, TerminableInterface /** * Filters a response object. * - * @param Response $response A Response instance - * @param Request $request An error message in case the response is not a Response object - * @param int $type The type of the request (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) + * @param Request $request An error message in case the response is not a Response object + * @param int $type The type of the request (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) * * @return Response The filtered Response instance * @@ -210,9 +208,8 @@ class HttpKernel implements HttpKernelInterface, TerminableInterface /** * Handles an exception by trying to convert it to a Response. * - * @param \Exception $e An \Exception instance - * @param Request $request A Request instance - * @param int $type The type of the request (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) + * @param \Exception $e An \Exception instance + * @param int $type The type of the request (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) * * @throws \Exception */ diff --git a/src/Symfony/Component/HttpKernel/HttpKernelInterface.php b/src/Symfony/Component/HttpKernel/HttpKernelInterface.php index 5050bfcfba..7595d29d04 100644 --- a/src/Symfony/Component/HttpKernel/HttpKernelInterface.php +++ b/src/Symfony/Component/HttpKernel/HttpKernelInterface.php @@ -30,10 +30,9 @@ interface HttpKernelInterface * When $catch is true, the implementation must catch all exceptions * and do its best to convert them to a Response instance. * - * @param Request $request A Request instance - * @param int $type The type of the request - * (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) - * @param bool $catch Whether to catch exceptions or not + * @param int $type The type of the request + * (one of HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST) + * @param bool $catch Whether to catch exceptions or not * * @return Response A Response instance * diff --git a/src/Symfony/Component/Ldap/Adapter/AbstractConnection.php b/src/Symfony/Component/Ldap/Adapter/AbstractConnection.php index a43e2535d2..b82d7146ea 100644 --- a/src/Symfony/Component/Ldap/Adapter/AbstractConnection.php +++ b/src/Symfony/Component/Ldap/Adapter/AbstractConnection.php @@ -30,11 +30,6 @@ abstract class AbstractConnection implements ConnectionInterface $this->config = $resolver->resolve($config); } - /** - * Configures the adapter's options. - * - * @param OptionsResolver $resolver An OptionsResolver instance - */ protected function configureOptions(OptionsResolver $resolver) { $resolver->setDefaults([ diff --git a/src/Symfony/Component/Routing/Loader/YamlFileLoader.php b/src/Symfony/Component/Routing/Loader/YamlFileLoader.php index 15c223ecad..2dba247273 100644 --- a/src/Symfony/Component/Routing/Loader/YamlFileLoader.php +++ b/src/Symfony/Component/Routing/Loader/YamlFileLoader.php @@ -101,10 +101,9 @@ class YamlFileLoader extends FileLoader /** * Parses a route and adds it to the RouteCollection. * - * @param RouteCollection $collection A RouteCollection instance - * @param string $name Route name - * @param array $config Route definition - * @param string $path Full path of the YAML file being processed + * @param string $name Route name + * @param array $config Route definition + * @param string $path Full path of the YAML file being processed */ protected function parseRoute(RouteCollection $collection, $name, array $config, $path) { @@ -154,10 +153,9 @@ class YamlFileLoader extends FileLoader /** * Parses an import and adds the routes in the resource to the RouteCollection. * - * @param RouteCollection $collection A RouteCollection instance - * @param array $config Route definition - * @param string $path Full path of the YAML file being processed - * @param string $file Loaded file name + * @param array $config Route definition + * @param string $path Full path of the YAML file being processed + * @param string $file Loaded file name */ protected function parseImport(RouteCollection $collection, array $config, $path, $file) { diff --git a/src/Symfony/Component/Routing/Router.php b/src/Symfony/Component/Routing/Router.php index a472281370..538d9fa915 100644 --- a/src/Symfony/Component/Routing/Router.php +++ b/src/Symfony/Component/Routing/Router.php @@ -96,11 +96,8 @@ class Router implements RouterInterface, RequestMatcherInterface private $expressionLanguageProviders = []; /** - * @param LoaderInterface $loader A LoaderInterface instance - * @param mixed $resource The main resource to load - * @param array $options An array of options - * @param RequestContext $context The context - * @param LoggerInterface $logger A logger instance + * @param mixed $resource The main resource to load + * @param array $options An array of options */ public function __construct(LoaderInterface $loader, $resource, array $options = [], RequestContext $context = null, LoggerInterface $logger = null, string $defaultLocale = null) { diff --git a/src/Symfony/Component/Security/Core/Authentication/Provider/RememberMeAuthenticationProvider.php b/src/Symfony/Component/Security/Core/Authentication/Provider/RememberMeAuthenticationProvider.php index 904026b6ba..af0ec53c05 100644 --- a/src/Symfony/Component/Security/Core/Authentication/Provider/RememberMeAuthenticationProvider.php +++ b/src/Symfony/Component/Security/Core/Authentication/Provider/RememberMeAuthenticationProvider.php @@ -24,9 +24,8 @@ class RememberMeAuthenticationProvider implements AuthenticationProviderInterfac private $providerKey; /** - * @param UserCheckerInterface $userChecker An UserCheckerInterface interface - * @param string $secret A secret - * @param string $providerKey A provider secret + * @param string $secret A secret + * @param string $providerKey A provider secret */ public function __construct(UserCheckerInterface $userChecker, string $secret, string $providerKey) { diff --git a/src/Symfony/Component/Security/Core/Authorization/AccessDecisionManagerInterface.php b/src/Symfony/Component/Security/Core/Authorization/AccessDecisionManagerInterface.php index 723ef19c41..97eb4f9d41 100644 --- a/src/Symfony/Component/Security/Core/Authorization/AccessDecisionManagerInterface.php +++ b/src/Symfony/Component/Security/Core/Authorization/AccessDecisionManagerInterface.php @@ -23,9 +23,8 @@ interface AccessDecisionManagerInterface /** * Decides whether the access is possible or not. * - * @param TokenInterface $token A TokenInterface instance - * @param array $attributes An array of attributes associated with the method being invoked - * @param object $object The object to secure + * @param array $attributes An array of attributes associated with the method being invoked + * @param object $object The object to secure * * @return bool true if the access is granted, false otherwise */ diff --git a/src/Symfony/Component/Security/Core/Authorization/Voter/VoterInterface.php b/src/Symfony/Component/Security/Core/Authorization/Voter/VoterInterface.php index 4bb73672c0..76c1968f5e 100644 --- a/src/Symfony/Component/Security/Core/Authorization/Voter/VoterInterface.php +++ b/src/Symfony/Component/Security/Core/Authorization/Voter/VoterInterface.php @@ -30,9 +30,8 @@ interface VoterInterface * This method must return one of the following constants: * ACCESS_GRANTED, ACCESS_DENIED, or ACCESS_ABSTAIN. * - * @param TokenInterface $token A TokenInterface instance - * @param mixed $subject The subject to secure - * @param array $attributes An array of attributes associated with the method being invoked + * @param mixed $subject The subject to secure + * @param array $attributes An array of attributes associated with the method being invoked * * @return int either ACCESS_GRANTED, ACCESS_ABSTAIN, or ACCESS_DENIED */ diff --git a/src/Symfony/Component/Security/Guard/Firewall/GuardAuthenticationListener.php b/src/Symfony/Component/Security/Guard/Firewall/GuardAuthenticationListener.php index 9b778fc311..bcfa30dc58 100644 --- a/src/Symfony/Component/Security/Guard/Firewall/GuardAuthenticationListener.php +++ b/src/Symfony/Component/Security/Guard/Firewall/GuardAuthenticationListener.php @@ -45,11 +45,8 @@ class GuardAuthenticationListener implements ListenerInterface private $rememberMeServices; /** - * @param GuardAuthenticatorHandler $guardHandler The Guard handler - * @param AuthenticationManagerInterface $authenticationManager An AuthenticationManagerInterface instance - * @param string $providerKey The provider (i.e. firewall) key - * @param iterable|AuthenticatorInterface[] $guardAuthenticators The authenticators, with keys that match what's passed to GuardAuthenticationProvider - * @param LoggerInterface $logger A LoggerInterface instance + * @param string $providerKey The provider (i.e. firewall) key + * @param iterable|AuthenticatorInterface[] $guardAuthenticators The authenticators, with keys that match what's passed to GuardAuthenticationProvider */ public function __construct(GuardAuthenticatorHandler $guardHandler, AuthenticationManagerInterface $authenticationManager, string $providerKey, $guardAuthenticators, LoggerInterface $logger = null) { diff --git a/src/Symfony/Component/Security/Http/AccessMap.php b/src/Symfony/Component/Security/Http/AccessMap.php index 04c06da107..1a64f2dace 100644 --- a/src/Symfony/Component/Security/Http/AccessMap.php +++ b/src/Symfony/Component/Security/Http/AccessMap.php @@ -25,9 +25,8 @@ class AccessMap implements AccessMapInterface private $map = []; /** - * @param RequestMatcherInterface $requestMatcher A RequestMatcherInterface instance - * @param array $attributes An array of attributes to pass to the access decision manager (like roles) - * @param string|null $channel The channel to enforce (http, https, or null) + * @param array $attributes An array of attributes to pass to the access decision manager (like roles) + * @param string|null $channel The channel to enforce (http, https, or null) */ public function add(RequestMatcherInterface $requestMatcher, array $attributes = [], $channel = null) { diff --git a/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationFailureHandler.php b/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationFailureHandler.php index 1440179131..f49f1808fd 100644 --- a/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationFailureHandler.php +++ b/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationFailureHandler.php @@ -22,8 +22,7 @@ class CustomAuthenticationFailureHandler implements AuthenticationFailureHandler private $handler; /** - * @param AuthenticationFailureHandlerInterface $handler An AuthenticationFailureHandlerInterface instance - * @param array $options Options for processing a successful authentication attempt + * @param array $options Options for processing a successful authentication attempt */ public function __construct(AuthenticationFailureHandlerInterface $handler, array $options) { diff --git a/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationSuccessHandler.php b/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationSuccessHandler.php index 357906a8ce..c84bcefba0 100644 --- a/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationSuccessHandler.php +++ b/src/Symfony/Component/Security/Http/Authentication/CustomAuthenticationSuccessHandler.php @@ -22,9 +22,8 @@ class CustomAuthenticationSuccessHandler implements AuthenticationSuccessHandler private $handler; /** - * @param AuthenticationSuccessHandlerInterface $handler An AuthenticationSuccessHandlerInterface instance - * @param array $options Options for processing a successful authentication attempt - * @param string $providerKey The provider key + * @param array $options Options for processing a successful authentication attempt + * @param string $providerKey The provider key */ public function __construct(AuthenticationSuccessHandlerInterface $handler, array $options, string $providerKey) { diff --git a/src/Symfony/Component/Security/Http/EntryPoint/FormAuthenticationEntryPoint.php b/src/Symfony/Component/Security/Http/EntryPoint/FormAuthenticationEntryPoint.php index 04e7033d85..c887ca44b1 100644 --- a/src/Symfony/Component/Security/Http/EntryPoint/FormAuthenticationEntryPoint.php +++ b/src/Symfony/Component/Security/Http/EntryPoint/FormAuthenticationEntryPoint.php @@ -29,10 +29,8 @@ class FormAuthenticationEntryPoint implements AuthenticationEntryPointInterface private $httpUtils; /** - * @param HttpKernelInterface $kernel - * @param HttpUtils $httpUtils An HttpUtils instance - * @param string $loginPath The path to the login form - * @param bool $useForward Whether to forward or redirect to the login form + * @param string $loginPath The path to the login form + * @param bool $useForward Whether to forward or redirect to the login form */ public function __construct(HttpKernelInterface $kernel, HttpUtils $httpUtils, string $loginPath, bool $useForward = false) { diff --git a/src/Symfony/Component/Security/Http/Firewall/LogoutListener.php b/src/Symfony/Component/Security/Http/Firewall/LogoutListener.php index 4dabe20a9c..7f9343dc5e 100644 --- a/src/Symfony/Component/Security/Http/Firewall/LogoutListener.php +++ b/src/Symfony/Component/Security/Http/Firewall/LogoutListener.php @@ -42,11 +42,8 @@ class LogoutListener implements ListenerInterface private $csrfTokenManager; /** - * @param TokenStorageInterface $tokenStorage - * @param HttpUtils $httpUtils An HttpUtils instance - * @param LogoutSuccessHandlerInterface $successHandler A LogoutSuccessHandlerInterface instance - * @param array $options An array of options to process a logout attempt - * @param CsrfTokenManagerInterface|null $csrfTokenManager A CsrfTokenManagerInterface instance + * @param TokenStorageInterface $tokenStorage + * @param array $options An array of options to process a logout attempt */ public function __construct(TokenStorageInterface $tokenStorage, HttpUtils $httpUtils, LogoutSuccessHandlerInterface $successHandler, array $options = [], CsrfTokenManagerInterface $csrfTokenManager = null) { diff --git a/src/Symfony/Component/Security/Http/HttpUtils.php b/src/Symfony/Component/Security/Http/HttpUtils.php index b31117a06f..5dbc928db0 100644 --- a/src/Symfony/Component/Security/Http/HttpUtils.php +++ b/src/Symfony/Component/Security/Http/HttpUtils.php @@ -33,7 +33,6 @@ class HttpUtils private $secureDomainRegexp; /** - * @param UrlGeneratorInterface $urlGenerator A UrlGeneratorInterface instance * @param UrlMatcherInterface|RequestMatcherInterface $urlMatcher The URL or Request matcher * @param string|null $domainRegexp A regexp the target of HTTP redirections must match, scheme included * @param string|null $secureDomainRegexp A regexp the target of HTTP redirections must match when the scheme is "https" @@ -54,9 +53,8 @@ class HttpUtils /** * Creates a redirect Response. * - * @param Request $request A Request instance - * @param string $path A path (an absolute path (/foo), an absolute URL (http://...), or a route name (foo)) - * @param int $status The status code + * @param string $path A path (an absolute path (/foo), an absolute URL (http://...), or a route name (foo)) + * @param int $status The status code * * @return RedirectResponse A RedirectResponse instance */ @@ -114,8 +112,7 @@ class HttpUtils /** * Checks that a given path matches the Request. * - * @param Request $request A Request instance - * @param string $path A path (an absolute path (/foo), an absolute URL (http://...), or a route name (foo)) + * @param string $path A path (an absolute path (/foo), an absolute URL (http://...), or a route name (foo)) * * @return bool true if the path is the same as the one from the Request, false otherwise */ diff --git a/src/Symfony/Component/Serializer/Normalizer/DenormalizerAwareTrait.php b/src/Symfony/Component/Serializer/Normalizer/DenormalizerAwareTrait.php index ff8528bff9..588f453215 100644 --- a/src/Symfony/Component/Serializer/Normalizer/DenormalizerAwareTrait.php +++ b/src/Symfony/Component/Serializer/Normalizer/DenormalizerAwareTrait.php @@ -23,11 +23,6 @@ trait DenormalizerAwareTrait */ protected $denormalizer; - /** - * Sets the Denormalizer. - * - * @param DenormalizerInterface $denormalizer A DenormalizerInterface instance - */ public function setDenormalizer(DenormalizerInterface $denormalizer) { $this->denormalizer = $denormalizer; diff --git a/src/Symfony/Component/Serializer/Normalizer/NormalizerAwareTrait.php b/src/Symfony/Component/Serializer/Normalizer/NormalizerAwareTrait.php index 7d60587550..897fb4c16d 100644 --- a/src/Symfony/Component/Serializer/Normalizer/NormalizerAwareTrait.php +++ b/src/Symfony/Component/Serializer/Normalizer/NormalizerAwareTrait.php @@ -23,11 +23,6 @@ trait NormalizerAwareTrait */ protected $normalizer; - /** - * Sets the normalizer. - * - * @param NormalizerInterface $normalizer A NormalizerInterface instance - */ public function setNormalizer(NormalizerInterface $normalizer) { $this->normalizer = $normalizer; diff --git a/src/Symfony/Component/Serializer/SerializerAwareTrait.php b/src/Symfony/Component/Serializer/SerializerAwareTrait.php index 7f5839eef3..fcdac52c6a 100644 --- a/src/Symfony/Component/Serializer/SerializerAwareTrait.php +++ b/src/Symfony/Component/Serializer/SerializerAwareTrait.php @@ -23,11 +23,6 @@ trait SerializerAwareTrait */ protected $serializer; - /** - * Sets the serializer. - * - * @param SerializerInterface $serializer A SerializerInterface instance - */ public function setSerializer(SerializerInterface $serializer) { $this->serializer = $serializer; diff --git a/src/Symfony/Component/Templating/Loader/CacheLoader.php b/src/Symfony/Component/Templating/Loader/CacheLoader.php index 0e00ef06f7..21849374c4 100644 --- a/src/Symfony/Component/Templating/Loader/CacheLoader.php +++ b/src/Symfony/Component/Templating/Loader/CacheLoader.php @@ -30,8 +30,7 @@ class CacheLoader extends Loader protected $dir; /** - * @param LoaderInterface $loader A Loader instance - * @param string $dir The directory where to store the cache files + * @param string $dir The directory where to store the cache files */ public function __construct(LoaderInterface $loader, string $dir) { diff --git a/src/Symfony/Component/Translation/Translator.php b/src/Symfony/Component/Translation/Translator.php index 798e43ef18..048e5b68f9 100644 --- a/src/Symfony/Component/Translation/Translator.php +++ b/src/Symfony/Component/Translation/Translator.php @@ -108,8 +108,7 @@ class Translator implements LegacyTranslatorInterface, TranslatorInterface, Tran /** * Adds a Loader. * - * @param string $format The name of the loader (@see addResource()) - * @param LoaderInterface $loader A LoaderInterface instance + * @param string $format The name of the loader (@see addResource()) */ public function addLoader($format, LoaderInterface $loader) { diff --git a/src/Symfony/Component/VarDumper/Dumper/AbstractDumper.php b/src/Symfony/Component/VarDumper/Dumper/AbstractDumper.php index 9c0ff36fbf..8f36123f70 100644 --- a/src/Symfony/Component/VarDumper/Dumper/AbstractDumper.php +++ b/src/Symfony/Component/VarDumper/Dumper/AbstractDumper.php @@ -116,7 +116,6 @@ abstract class AbstractDumper implements DataDumperInterface, DumperInterface /** * Dumps a Data object. * - * @param Data $data A Data object * @param callable|resource|string|true|null $output A line dumper callable, an opened stream, an output path or true to return the dump * * @return string|null The dump as string when $output is true