Merge branch '4.4'

* 4.4:
  Remove unneeded phpdocs
This commit is contained in:
Nicolas Grekas 2019-08-08 11:49:33 +02:00
commit 0dc584e3ab
115 changed files with 149 additions and 428 deletions

View File

@ -40,10 +40,7 @@ class DoctrineChoiceLoader implements ChoiceLoaderInterface
* passed which optimizes the object loading for one of the Doctrine
* mapper implementations.
*
* @param ObjectManager $manager The object manager
* @param string $class The class name of the loaded objects
* @param IdReader|null $idReader The reader for the object IDs
* @param EntityLoaderInterface|null $objectLoader The objects loader
* @param string $class The class name of the loaded objects
*/
public function __construct(ObjectManager $manager, string $class, IdReader $idReader = null, EntityLoaderInterface $objectLoader = null)
{

View File

@ -32,11 +32,6 @@ class ORMQueryBuilderLoader implements EntityLoaderInterface
*/
private $queryBuilder;
/**
* Construct an ORM Query Builder Loader.
*
* @param QueryBuilder $queryBuilder The query builder for creating the query builder
*/
public function __construct(QueryBuilder $queryBuilder)
{
$this->queryBuilder = $queryBuilder;

View File

@ -31,8 +31,6 @@ class DoctrineTestHelper
/**
* Returns an entity manager for testing.
*
* @param Configuration|null $config
*
* @return EntityManager
*/
public static function createTestEntityManager(Configuration $config = null)

View File

@ -34,8 +34,7 @@ class UniqueEntityValidator extends ConstraintValidator
}
/**
* @param object $entity
* @param Constraint $constraint
* @param object $entity
*
* @throws UnexpectedTypeException
* @throws ConstraintDefinitionException

View File

@ -130,7 +130,6 @@ abstract class Descriptor implements DescriptorInterface
*
* @param Definition|Alias|object $service
* @param array $options
* @param ContainerBuilder|null $builder
*/
abstract protected function describeContainerService($service, array $options = [], ContainerBuilder $builder = null);

View File

@ -46,7 +46,6 @@ class RedirectController
* In case the route name is empty, the status code will be 404 when permanent is false
* and 410 otherwise.
*
* @param Request $request The request instance
* @param string $route The route name to redirect to
* @param bool $permanent Whether the redirection is permanent
* @param bool|array $ignoreAttributes Whether to ignore attributes or an array of attributes to ignore
@ -88,7 +87,6 @@ class RedirectController
* In case the path is empty, the status code will be 404 when permanent is false
* and 410 otherwise.
*
* @param Request $request The request instance
* @param string $path The absolute path or URL to redirect to
* @param bool $permanent Whether the redirect is permanent or not
* @param string|null $scheme The URL scheme (null to keep the current one)

View File

@ -29,8 +29,6 @@ trait MicroKernelTrait
*
* $routes->import('config/routing.yml');
* $routes->add('/admin', 'App\Controller\AdminController::dashboard', 'admin_dashboard');
*
* @param RouteCollectionBuilder $routes
*/
abstract protected function configureRoutes(RouteCollectionBuilder $routes);
@ -50,9 +48,6 @@ trait MicroKernelTrait
* Or parameters:
*
* $c->setParameter('halloween', 'lot of fun');
*
* @param ContainerBuilder $c
* @param LoaderInterface $loader
*/
abstract protected function configureContainer(ContainerBuilder $c, LoaderInterface $loader);

View File

@ -33,8 +33,6 @@ class VoteListener implements EventSubscriberInterface
/**
* Event dispatched by a voter during access manager decision.
*
* @param VoteEvent $event event with voter data
*/
public function onVoterVote(VoteEvent $event)
{

View File

@ -26,8 +26,7 @@ class Packages
private $packages = [];
/**
* @param PackageInterface $defaultPackage The default package
* @param PackageInterface[] $packages Additional packages indexed by name
* @param PackageInterface[] $packages Additional packages indexed by name
*/
public function __construct(PackageInterface $defaultPackage = null, array $packages = [])
{
@ -43,9 +42,6 @@ class Packages
$this->defaultPackage = $defaultPackage;
}
/**
* Adds a package.
*/
public function addPackage(string $name, PackageInterface $package)
{
$this->packages[$name] = $package;

View File

@ -29,9 +29,7 @@ class PathPackage extends Package
private $basePath;
/**
* @param string $basePath The base path to be prepended to relative paths
* @param VersionStrategyInterface $versionStrategy The version strategy
* @param ContextInterface|null $context The context
* @param string $basePath The base path to be prepended to relative paths
*/
public function __construct(string $basePath, VersionStrategyInterface $versionStrategy, ContextInterface $context = null)
{

View File

@ -39,9 +39,7 @@ class UrlPackage extends Package
private $sslPackage;
/**
* @param string|string[] $baseUrls Base asset URLs
* @param VersionStrategyInterface $versionStrategy The version strategy
* @param ContextInterface|null $context Context
* @param string|string[] $baseUrls Base asset URLs
*/
public function __construct($baseUrls, VersionStrategyInterface $versionStrategy, ContextInterface $context = null)
{

View File

@ -71,7 +71,6 @@ class RedisTagAwareAdapter extends AbstractTagAwareAdapter
* @param \Redis|\RedisArray|\RedisCluster|\Predis\Client $redisClient The redis client
* @param string $namespace The default namespace
* @param int $defaultLifetime The default lifetime
* @param MarshallerInterface|null $marshaller
*
* @throws \Symfony\Component\Cache\Exception\LogicException If phpredis with version lower than 3.1.3.
*/

View File

@ -30,8 +30,7 @@ class CacheDataCollector extends DataCollector implements LateDataCollectorInter
private $instances = [];
/**
* @param string $name
* @param TraceableAdapter $instance
* @param string $name
*/
public function addInstance(string $name, TraceableAdapter $instance)
{

View File

@ -23,8 +23,7 @@ class Processor
/**
* Processes an array of configurations.
*
* @param NodeInterface $configTree The node tree describing the configuration
* @param array $configs An array of configuration items to process
* @param array $configs An array of configuration items to process
*
* @return array The processed configuration
*/
@ -42,8 +41,7 @@ class Processor
/**
* Processes an array of configurations.
*
* @param ConfigurationInterface $configuration The configuration class
* @param array $configs An array of configuration items to process
* @param array $configs An array of configuration items to process
*
* @return array The processed configuration
*/

View File

@ -30,8 +30,6 @@ interface ResourceCheckerInterface
* Queries the ResourceChecker whether it can validate a given
* resource or not.
*
* @param ResourceInterface $metadata The resource to be checked for freshness
*
* @return bool True if the ResourceChecker can handle this resource type, false if not
*/
public function supports(ResourceInterface $metadata);
@ -39,8 +37,7 @@ interface ResourceCheckerInterface
/**
* Validates the resource.
*
* @param ResourceInterface $resource The resource to be validated
* @param int $timestamp The timestamp at which the cache associated with this resource was created
* @param int $timestamp The timestamp at which the cache associated with this resource was created
*
* @return bool True if the resource has not changed since the given timestamp, false otherwise
*/

View File

@ -25,8 +25,7 @@ class ContainerCommandLoader implements CommandLoaderInterface
private $commandMap;
/**
* @param ContainerInterface $container A container from which to load command services
* @param array $commandMap An array with command names as keys and service ids as values
* @param array $commandMap An array with command names as keys and service ids as values
*/
public function __construct(ContainerInterface $container, array $commandMap)
{

View File

@ -23,9 +23,8 @@ interface DescriptorInterface
/**
* Describes an object if supported.
*
* @param OutputInterface $output
* @param object $object
* @param array $options
* @param object $object
* @param array $options
*/
public function describe(OutputInterface $output, $object, array $options = []);
}

View File

@ -48,9 +48,8 @@ class DescriptorHelper extends Helper
* * format: string, the output format name
* * raw_text: boolean, sets output type as raw
*
* @param OutputInterface $output
* @param object $object
* @param array $options
* @param object $object
* @param array $options
*
* @throws InvalidArgumentException when the given format is not supported
*/
@ -72,8 +71,7 @@ class DescriptorHelper extends Helper
/**
* Registers a descriptor.
*
* @param string $format
* @param DescriptorInterface $descriptor
* @param string $format
*
* @return $this
*/

View File

@ -25,7 +25,6 @@ class SyntaxErrorException extends ParseException
{
/**
* @param string $expectedValue
* @param Token $foundToken
*
* @return self
*/

View File

@ -30,9 +30,8 @@ class FunctionNode extends AbstractNode
private $arguments;
/**
* @param NodeInterface $selector
* @param string $name
* @param Token[] $arguments
* @param string $name
* @param Token[] $arguments
*/
public function __construct(NodeInterface $selector, string $name, array $arguments = [])
{

View File

@ -438,9 +438,8 @@ class ContainerBuilder extends Container implements TaggedContainerInterface
/**
* Adds a compiler pass.
*
* @param CompilerPassInterface $pass A compiler pass
* @param string $type The type of compiler pass
* @param int $priority Used to sort the passes
* @param string $type The type of compiler pass
* @param int $priority Used to sort the passes
*
* @return $this
*/

View File

@ -25,10 +25,8 @@ interface InstantiatorInterface
/**
* Instantiates a proxy object.
*
* @param ContainerInterface $container The container from which the service is being requested
* @param Definition $definition The definition of the requested service
* @param string $id Identifier of the requested service
* @param callable $realInstantiator Zero-argument callback that is capable of producing the real service instance
* @param string $id Identifier of the requested service
* @param callable $realInstantiator Zero-argument callback that is capable of producing the real service instance
*
* @return object
*/

View File

@ -86,8 +86,7 @@ abstract class FileLoader extends BaseFileLoader
/**
* Registers a definition in the container with its instanceof-conditionals.
*
* @param string $id
* @param Definition $definition
* @param string $id
*/
protected function setDefinition($id, Definition $definition)
{

View File

@ -29,7 +29,6 @@ class ExpressionLanguage
protected $functions = [];
/**
* @param CacheItemPoolInterface $cache
* @param ExpressionFunctionProviderInterface[] $providers
*/
public function __construct(CacheItemPoolInterface $cache = null, array $providers = [])

View File

@ -181,8 +181,7 @@ class ButtonBuilder implements \IteratorAggregate, FormBuilderInterface
*
* This method should not be invoked.
*
* @param DataTransformerInterface $viewTransformer
* @param bool $forcePrepend
* @param bool $forcePrepend
*
* @throws BadMethodCallException
*/
@ -208,8 +207,7 @@ class ButtonBuilder implements \IteratorAggregate, FormBuilderInterface
*
* This method should not be invoked.
*
* @param DataTransformerInterface $modelTransformer
* @param bool $forceAppend
* @param bool $forceAppend
*
* @throws BadMethodCallException
*/

View File

@ -90,9 +90,8 @@ class PropertyAccessDecorator implements ChoiceListFactoryInterface
/**
* {@inheritdoc}
*
* @param ChoiceLoaderInterface $loader The choice loader
* @param callable|string|PropertyPath|null $value The callable or path for
* generating the choice values
* @param callable|string|PropertyPath|null $value The callable or path for
* generating the choice values
*
* @return ChoiceListInterface The choice list
*/
@ -121,7 +120,6 @@ class PropertyAccessDecorator implements ChoiceListFactoryInterface
/**
* {@inheritdoc}
*
* @param ChoiceListInterface $list The choice list
* @param array|callable|string|PropertyPath|null $preferredChoices The preferred choices
* @param callable|string|PropertyPath|null $label The callable or path generating the choice labels
* @param callable|string|PropertyPath|null $index The callable or path generating the view indices

View File

@ -45,8 +45,7 @@ class LazyChoiceList implements ChoiceListInterface
* The callable receives the choice as first and the array key as the second
* argument.
*
* @param ChoiceLoaderInterface $loader The choice loader
* @param callable|null $value The callable generating the choice values
* @param callable|null $value The callable generating the choice values
*/
public function __construct(ChoiceLoaderInterface $loader, callable $value = null)
{

View File

@ -46,9 +46,6 @@ class FormTypeCsrfExtension extends AbstractTypeExtension
/**
* Adds a CSRF field to the form when the CSRF protection is enabled.
*
* @param FormBuilderInterface $builder The form builder
* @param array $options The options
*/
public function buildForm(FormBuilderInterface $builder, array $options)
{
@ -71,10 +68,6 @@ class FormTypeCsrfExtension extends AbstractTypeExtension
/**
* Adds a CSRF field to the root form view.
*
* @param FormView $view The form view
* @param FormInterface $form The form
* @param array $options The options
*/
public function finishView(FormView $view, FormInterface $form, array $options)
{

View File

@ -25,9 +25,8 @@ class DependencyInjectionExtension implements FormExtensionInterface
private $guesserServices;
/**
* @param ContainerInterface $typeContainer
* @param iterable[] $typeExtensionServices
* @param iterable $guesserServices
* @param iterable[] $typeExtensionServices
* @param iterable $guesserServices
*/
public function __construct(ContainerInterface $typeContainer, array $typeExtensionServices, iterable $guesserServices)
{

View File

@ -187,7 +187,6 @@ class FormValidator extends ConstraintValidator
* Post-processes the validation groups option for a given form.
*
* @param string|GroupSequence|(string|GroupSequence)[]|callable $groups The validation groups
* @param FormInterface $form The validated form
*
* @return (string|GroupSequence)[] The validation groups
*/

View File

@ -41,11 +41,6 @@ class ValidationListener implements EventSubscriberInterface
$this->violationMapper = $violationMapper;
}
/**
* Validates the form and its domain object.
*
* @param FormEvent $event The event object
*/
public function validateForm(FormEvent $event)
{
$form = $event->getForm();

View File

@ -23,9 +23,7 @@ interface ViolationMapperInterface
* Maps a constraint violation to a form in the form tree under
* the given form.
*
* @param ConstraintViolation $violation The violation to map
* @param FormInterface $form The root form of the tree to map it to
* @param bool $allowNonSynchronized Whether to allow mapping to non-synchronized forms
* @param bool $allowNonSynchronized Whether to allow mapping to non-synchronized forms
*/
public function mapViolation(ConstraintViolation $violation, FormInterface $form, $allowNonSynchronized = false);
}

View File

@ -47,8 +47,7 @@ interface FormConfigBuilderInterface extends FormConfigInterface
* The reverseTransform method of the transformer is used to convert from the
* view to the normalized format.
*
* @param DataTransformerInterface $viewTransformer
* @param bool $forcePrepend If set to true, prepend instead of appending
* @param bool $forcePrepend If set to true, prepend instead of appending
*
* @return $this The configuration object
*/
@ -69,8 +68,7 @@ interface FormConfigBuilderInterface extends FormConfigInterface
* The reverseTransform method of the transformer is used to convert from the
* normalized to the model format.
*
* @param DataTransformerInterface $modelTransformer
* @param bool $forceAppend If set to true, append instead of prepending
* @param bool $forceAppend If set to true, append instead of prepending
*
* @return $this The configuration object
*/

View File

@ -111,8 +111,6 @@ class FormError
*
* This method must only be called once.
*
* @param FormInterface $origin The form that caused this error
*
* @throws BadMethodCallException If the method is called more than once
*/
public function setOrigin(FormInterface $origin)

View File

@ -39,7 +39,6 @@ class FormErrorIterator implements \RecursiveIterator, \SeekableIterator, \Array
private $errors;
/**
* @param FormInterface $form The erroneous form
* @param FormError[]|self[] $errors An array of form errors and instances
* of FormErrorIterator
*

View File

@ -22,8 +22,7 @@ class FormEvent extends Event
protected $data;
/**
* @param FormInterface $form The associated form
* @param mixed $data The data
* @param mixed $data The data
*/
public function __construct(FormInterface $form, $data)
{

View File

@ -23,9 +23,8 @@ interface FormFactoryInterface
*
* @see createBuilder()
*
* @param string $type The type of the form
* @param mixed $data The initial data
* @param array $options The options
* @param string $type The type of the form
* @param mixed $data The initial data
*
* @return FormInterface The form named after the type
*
@ -56,7 +55,6 @@ interface FormFactoryInterface
* @param string $class The fully qualified class name
* @param string $property The name of the property to guess for
* @param mixed $data The initial data
* @param array $options The options for the builder
*
* @return FormInterface The form named after the property
*
@ -67,9 +65,8 @@ interface FormFactoryInterface
/**
* Returns a form builder.
*
* @param string $type The type of the form
* @param mixed $data The initial data
* @param array $options The options
* @param string $type The type of the form
* @param mixed $data The initial data
*
* @return FormBuilderInterface The form builder
*
@ -99,7 +96,6 @@ interface FormFactoryInterface
* @param string $class The fully qualified class name
* @param string $property The name of the property to guess for
* @param mixed $data The initial data
* @param array $options The options for the builder
*
* @return FormBuilderInterface The form builder named after the property
*

View File

@ -208,8 +208,6 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
/**
* Adds an error to this form.
*
* @param FormError $error
*
* @return $this
*/
public function addError(FormError $error);

View File

@ -48,8 +48,7 @@ class FormRegistry implements FormRegistryInterface
private $checkedTypes = [];
/**
* @param FormExtensionInterface[] $extensions An array of FormExtensionInterface
* @param ResolvedFormTypeFactoryInterface $resolvedTypeFactory The factory for resolved form types
* @param FormExtensionInterface[] $extensions An array of FormExtensionInterface
*
* @throws UnexpectedTypeException if any extension does not implement FormExtensionInterface
*/

View File

@ -48,11 +48,6 @@ interface FormTypeExtensionInterface
*/
public function finishView(FormView $view, FormInterface $form, array $options);
/**
* Configures the options for this type.
*
* @param OptionsResolver $resolver The resolver for the options
*/
public function configureOptions(OptionsResolver $resolver);
/**

View File

@ -25,9 +25,6 @@ interface FormTypeInterface
* top most type. Type extensions can further modify the form.
*
* @see FormTypeExtensionInterface::buildForm()
*
* @param FormBuilderInterface $builder The form builder
* @param array $options The options
*/
public function buildForm(FormBuilderInterface $builder, array $options);
@ -42,10 +39,6 @@ interface FormTypeInterface
* to do so, move your logic to {@link finishView()} instead.
*
* @see FormTypeExtensionInterface::buildView()
*
* @param FormView $view The view
* @param FormInterface $form The form
* @param array $options The options
*/
public function buildView(FormView $view, FormInterface $form, array $options);
@ -61,17 +54,11 @@ interface FormTypeInterface
* else you are recommended to implement {@link buildView()} instead.
*
* @see FormTypeExtensionInterface::finishView()
*
* @param FormView $view The view
* @param FormInterface $form The form
* @param array $options The options
*/
public function finishView(FormView $view, FormInterface $form, array $options);
/**
* Configures the options for this type.
*
* @param OptionsResolver $resolver The resolver for the options
*/
public function configureOptions(OptionsResolver $resolver);

View File

@ -29,7 +29,6 @@ class PreloadedExtension implements FormExtensionInterface
*
* @param FormTypeInterface[] $types The types that the extension should support
* @param FormTypeExtensionInterface[][] $typeExtensions The type extensions that the extension should support
* @param FormTypeGuesserInterface|null $typeGuesser The guesser that the extension should support
*/
public function __construct(array $types, array $typeExtensions, FormTypeGuesserInterface $typeGuesser = null)
{

View File

@ -21,8 +21,7 @@ interface RequestHandlerInterface
/**
* Submits a form if it was submitted.
*
* @param FormInterface $form The form to submit
* @param mixed $request The current request
* @param mixed $request The current request
*/
public function handleRequest(FormInterface $form, $request = null);

View File

@ -118,9 +118,6 @@ class ResolvedFormType implements ResolvedFormTypeInterface
/**
* Configures a form builder for the type hierarchy.
*
* @param FormBuilderInterface $builder The builder to configure
* @param array $options The options used for the configuration
*/
public function buildForm(FormBuilderInterface $builder, array $options)
{
@ -139,10 +136,6 @@ class ResolvedFormType implements ResolvedFormTypeInterface
* Configures a form view for the type hierarchy.
*
* This method is called before the children of the view are built.
*
* @param FormView $view The form view to configure
* @param FormInterface $form The form corresponding to the view
* @param array $options The options used for the configuration
*/
public function buildView(FormView $view, FormInterface $form, array $options)
{
@ -161,10 +154,6 @@ class ResolvedFormType implements ResolvedFormTypeInterface
* Finishes a form view for the type hierarchy.
*
* This method is called after the children of the view have been built.
*
* @param FormView $view The form view to configure
* @param FormInterface $form The form corresponding to the view
* @param array $options The options used for the configuration
*/
public function finishView(FormView $view, FormInterface $form, array $options)
{
@ -209,10 +198,8 @@ class ResolvedFormType implements ResolvedFormTypeInterface
*
* Override this method if you want to customize the builder class.
*
* @param string $name The name of the builder
* @param string|null $dataClass The data class
* @param FormFactoryInterface $factory The current form factory
* @param array $options The builder options
* @param string $name The name of the builder
* @param string|null $dataClass The data class
*
* @return FormBuilderInterface The new builder instance
*/
@ -234,8 +221,6 @@ class ResolvedFormType implements ResolvedFormTypeInterface
*
* Override this method if you want to customize the view class.
*
* @param FormView|null $parent The parent view, if available
*
* @return FormView A new view instance
*/
protected function newView(FormView $parent = null)

View File

@ -25,9 +25,7 @@ interface ResolvedFormTypeFactoryInterface
/**
* Resolves a form type.
*
* @param FormTypeInterface $type
* @param FormTypeExtensionInterface[] $typeExtensions
* @param ResolvedFormTypeInterface|null $parent
* @param FormTypeExtensionInterface[] $typeExtensions
*
* @return ResolvedFormTypeInterface
*

View File

@ -51,9 +51,7 @@ interface ResolvedFormTypeInterface
/**
* Creates a new form builder for this type.
*
* @param FormFactoryInterface $factory The form factory
* @param string $name The name for the builder
* @param array $options The builder options
* @param string $name The name for the builder
*
* @return FormBuilderInterface The created form builder
*/
@ -62,18 +60,12 @@ interface ResolvedFormTypeInterface
/**
* Creates a new form view for a form of this type.
*
* @param FormInterface $form The form to create a view for
* @param FormView $parent The parent view or null
*
* @return FormView The created form view
*/
public function createView(FormInterface $form, FormView $parent = null);
/**
* Configures a form builder for the type hierarchy.
*
* @param FormBuilderInterface $builder The builder to configure
* @param array $options The options used for the configuration
*/
public function buildForm(FormBuilderInterface $builder, array $options);
@ -81,10 +73,6 @@ interface ResolvedFormTypeInterface
* Configures a form view for the type hierarchy.
*
* It is called before the children of the view are built.
*
* @param FormView $view The form view to configure
* @param FormInterface $form The form corresponding to the view
* @param array $options The options used for the configuration
*/
public function buildView(FormView $view, FormInterface $form, array $options);
@ -92,10 +80,6 @@ interface ResolvedFormTypeInterface
* Finishes a form view for the type hierarchy.
*
* It is called after the children of the view have been built.
*
* @param FormView $view The form view to configure
* @param FormInterface $form The form corresponding to the view
* @param array $options The options used for the configuration
*/
public function finishView(FormView $view, FormInterface $form, array $options);

View File

@ -54,10 +54,9 @@ abstract class AbstractFormTest extends TestCase
abstract protected function createForm();
/**
* @param string $name
* @param EventDispatcherInterface $dispatcher
* @param string|null $dataClass
* @param array $options
* @param string $name
* @param string|null $dataClass
* @param array $options
*
* @return FormBuilder
*/

View File

@ -744,11 +744,6 @@ class Request
return null !== $this->session;
}
/**
* Sets the Session.
*
* @param SessionInterface $session The Session
*/
public function setSession(SessionInterface $session)
{
$this->session = $session;

View File

@ -27,9 +27,8 @@ class MockFileSessionStorage extends MockArraySessionStorage
private $savePath;
/**
* @param string $savePath Path of directory to save session files
* @param string $name Session name
* @param MetadataBag $metaBag MetadataBag instance
* @param string $savePath Path of directory to save session files
* @param string $name Session name
*/
public function __construct(string $savePath = null, string $name = 'MOCKSESSID', MetadataBag $metaBag = null)
{

View File

@ -99,7 +99,6 @@ class NativeSessionStorage implements SessionStorageInterface
*
* @param array $options Session configuration options
* @param \SessionHandlerInterface|null $handler
* @param MetadataBag $metaBag MetadataBag
*/
public function __construct(array $options = [], $handler = null, MetadataBag $metaBag = null)
{

View File

@ -20,7 +20,6 @@ class PhpBridgeSessionStorage extends NativeSessionStorage
{
/**
* @param \SessionHandlerInterface|null $handler
* @param MetadataBag $metaBag MetadataBag
*/
public function __construct($handler = null, MetadataBag $metaBag = null)
{

View File

@ -24,7 +24,6 @@ interface ArgumentResolverInterface
/**
* Returns the arguments to pass to the controller.
*
* @param Request $request
* @param callable $controller
*
* @return array An array of arguments to pass to the controller

View File

@ -24,9 +24,6 @@ interface ArgumentValueResolverInterface
/**
* Whether this resolver can resolve the value for the given ArgumentMetadata.
*
* @param Request $request
* @param ArgumentMetadata $argument
*
* @return bool
*/
public function supports(Request $request, ArgumentMetadata $argument);
@ -34,9 +31,6 @@ interface ArgumentValueResolverInterface
/**
* Returns the possible value(s).
*
* @param Request $request
* @param ArgumentMetadata $argument
*
* @return iterable
*/
public function resolve(Request $request, ArgumentMetadata $argument);

View File

@ -27,10 +27,8 @@ class KernelEvent extends Event
private $requestType;
/**
* @param HttpKernelInterface $kernel The kernel in which this event was thrown
* @param Request $request The request the kernel is currently processing
* @param int $requestType The request type the kernel is currently processing; one of
* HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST
* @param int $requestType The request type the kernel is currently processing; one of
* HttpKernelInterface::MASTER_REQUEST or HttpKernelInterface::SUB_REQUEST
*/
public function __construct(HttpKernelInterface $kernel, Request $request, ?int $requestType)
{

View File

@ -50,7 +50,6 @@ class DebugHandlersListener implements EventSubscriberInterface
/**
* @param callable|null $exceptionHandler A handler that will be called on Exception
* @param LoggerInterface|null $logger A PSR-3 logger
* @param array|int $levels An array map of E_* to LogLevel::* or an integer bit field of E_* constants
* @param int|null $throwAt Thrown errors in a bit field of E_* constants, or null to keep the current value
* @param bool $scream Enables/disables screaming mode, where even silenced errors are logged

View File

@ -47,11 +47,7 @@ class ExceptionListener implements EventSubscriberInterface
$this->logException($event->getException(), sprintf('Uncaught PHP Exception %s: "%s" at %s line %s', $e->getClass(), $e->getMessage(), $e->getFile(), $e->getLine()));
}
/**
* @param string $eventName
* @param EventDispatcherInterface $eventDispatcher
*/
public function onKernelException(ExceptionEvent $event)
public function onKernelException(ExceptionEvent $event, ?string $eventName, EventDispatcherInterface $eventDispatcher)
{
if (null === $this->controller) {
return;
@ -59,7 +55,6 @@ class ExceptionListener implements EventSubscriberInterface
$exception = $event->getException();
$request = $this->duplicateRequest($exception, $event->getRequest());
$eventDispatcher = \func_num_args() > 2 ? func_get_arg(2) : null;
try {
$response = $event->getKernel()->handle($request, HttpKernelInterface::SUB_REQUEST, false);
@ -122,9 +117,6 @@ class ExceptionListener implements EventSubscriberInterface
/**
* Clones the request for the exception.
*
* @param \Exception $exception The thrown exception
* @param Request $request The original request
*/
protected function duplicateRequest(\Exception $exception, Request $request): Request
{

View File

@ -52,7 +52,6 @@ class RouterListener implements EventSubscriberInterface
/**
* @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
*
@ -90,8 +89,6 @@ class RouterListener implements EventSubscriberInterface
/**
* After a sub-request is done, we need to reset the routing context to the parent request so that the URL generator
* operates on the correct context again.
*
* @param FinishRequestEvent $event
*/
public function onKernelFinishRequest(FinishRequestEvent $event)
{

View File

@ -33,7 +33,6 @@ abstract class AbstractSurrogateFragmentRenderer extends RoutableFragmentRendere
* instance of InlineFragmentRenderer.
*
* @param FragmentRendererInterface $inlineStrategy The inline strategy to use when the surrogate is not supported
* @param UriSigner $signer
*/
public function __construct(SurrogateInterface $surrogate = null, FragmentRendererInterface $inlineStrategy, UriSigner $signer = null)
{

View File

@ -33,9 +33,8 @@ class FragmentHandler
private $requestStack;
/**
* @param RequestStack $requestStack The Request stack that controls the lifecycle of requests
* @param FragmentRendererInterface[] $renderers An array of FragmentRendererInterface instances
* @param bool $debug Whether the debug mode is enabled or not
* @param FragmentRendererInterface[] $renderers An array of FragmentRendererInterface instances
* @param bool $debug Whether the debug mode is enabled or not
*/
public function __construct(RequestStack $requestStack, array $renderers = [], bool $debug = false)
{

View File

@ -664,10 +664,8 @@ abstract class Kernel implements KernelInterface, RebootableInterface, Terminabl
/**
* Dumps the service container to PHP code in the cache.
*
* @param ConfigCache $cache The config cache
* @param ContainerBuilder $container The service container
* @param string $class The name of the class to generate
* @param string $baseClass The name of the container's base class
* @param string $class The name of the class to generate
* @param string $baseClass The name of the container's base class
*/
protected function dumpContainer(ConfigCache $cache, ContainerBuilder $container, $class, $baseClass)
{

View File

@ -26,8 +26,7 @@ class BufferedBundleReader implements BundleReaderInterface
/**
* Buffers a given reader.
*
* @param BundleReaderInterface $reader The reader to buffer
* @param int $bufferSize The number of entries to store in the buffer
* @param int $bufferSize The number of entries to store in the buffer
*/
public function __construct(BundleReaderInterface $reader, int $bufferSize)
{

View File

@ -91,8 +91,7 @@ abstract class AbstractDataGenerator
}
/**
* @param LocaleScanner $scanner
* @param string $sourceDir
* @param string $sourceDir
*
* @return string[]
*/

View File

@ -39,8 +39,7 @@ class GeneratorConfig
/**
* Adds a writer to be used during the data conversion.
*
* @param string $targetDir The output directory
* @param BundleWriterInterface $writer The writer instance
* @param string $targetDir The output directory
*/
public function addBundleWriter($targetDir, BundleWriterInterface $writer)
{

View File

@ -37,10 +37,8 @@ final class Lock implements LockInterface, LoggerAwareInterface
private $dirty = false;
/**
* @param Key $key Resource to lock
* @param PersistingStoreInterface $store Store used to handle lock persistence
* @param float|null $ttl Maximum expected lock duration in seconds
* @param bool $autoRelease Whether to automatically release the lock or not when the lock instance is destroyed
* @param float|null $ttl Maximum expected lock duration in seconds
* @param bool $autoRelease Whether to automatically release the lock or not when the lock instance is destroyed
*/
public function __construct(Key $key, PersistingStoreInterface $store, float $ttl = null, bool $autoRelease = true)
{

View File

@ -36,8 +36,7 @@ class CombinedStore implements PersistingStoreInterface, LoggerAwareInterface
private $strategy;
/**
* @param PersistingStoreInterface[] $stores The list of synchronized stores
* @param StrategyInterface $strategy
* @param PersistingStoreInterface[] $stores The list of synchronized stores
*
* @throws InvalidArgumentException
*/

View File

@ -34,9 +34,8 @@ class RetryTillSaveStore implements BlockingStoreInterface, LoggerAwareInterface
private $retryCount;
/**
* @param PersistingStoreInterface $decorated The decorated PersistingStoreInterface
* @param int $retrySleep Duration in ms between 2 retry
* @param int $retryCount Maximum amount of retry
* @param int $retrySleep Duration in ms between 2 retry
* @param int $retryCount Maximum amount of retry
*/
public function __construct(PersistingStoreInterface $decorated, int $retrySleep = 100, int $retryCount = PHP_INT_MAX)
{

View File

@ -29,9 +29,6 @@ class RoutableMessageBus implements MessageBusInterface
private $busLocator;
private $fallbackBus;
/**
* @param ContainerInterface $busLocator A locator full of MessageBusInterface objects
*/
public function __construct(ContainerInterface $busLocator, MessageBusInterface $fallbackBus = null)
{
$this->busLocator = $busLocator;

View File

@ -21,9 +21,8 @@ use Symfony\Component\PropertyAccess\PropertyPathInterface;
class UnexpectedTypeException extends RuntimeException
{
/**
* @param mixed $value The unexpected value found while traversing property path
* @param PropertyPathInterface $path The property path
* @param int $pathIndex The property path index when the unexpected value was found
* @param mixed $value The unexpected value found while traversing property path
* @param int $pathIndex The property path index when the unexpected value was found
*/
public function __construct($value, PropertyPathInterface $path, int $pathIndex)
{

View File

@ -138,8 +138,6 @@ class PropertyAccessorBuilder
/**
* Sets a cache system.
*
* @param CacheItemPoolInterface|null $cacheItemPool
*
* @return PropertyAccessorBuilder The builder object
*/
public function setCacheItemPool(CacheItemPoolInterface $cacheItemPool = null)

View File

@ -21,9 +21,6 @@ class PropertyPathIterator extends \ArrayIterator implements PropertyPathIterato
{
protected $path;
/**
* @param PropertyPathInterface $path The property path to traverse
*/
public function __construct(PropertyPathInterface $path)
{
parent::__construct($path->getElements());

View File

@ -52,10 +52,9 @@ class PhpDocExtractor implements PropertyDescriptionExtractorInterface, Property
private $arrayMutatorPrefixes;
/**
* @param DocBlockFactoryInterface $docBlockFactory
* @param string[]|null $mutatorPrefixes
* @param string[]|null $accessorPrefixes
* @param string[]|null $arrayMutatorPrefixes
* @param string[]|null $mutatorPrefixes
* @param string[]|null $accessorPrefixes
* @param string[]|null $arrayMutatorPrefixes
*/
public function __construct(DocBlockFactoryInterface $docBlockFactory = null, array $mutatorPrefixes = null, array $accessorPrefixes = null, array $arrayMutatorPrefixes = null)
{

View File

@ -63,10 +63,9 @@ class XmlFileLoader extends FileLoader
/**
* Parses a node from a loaded XML file.
*
* @param RouteCollection $collection Collection to associate with the node
* @param \DOMElement $node Element to parse
* @param string $path Full path of the XML file being processed
* @param string $file Loaded file name
* @param \DOMElement $node Element to parse
* @param string $path Full path of the XML file being processed
* @param string $file Loaded file name
*
* @throws \InvalidArgumentException When the XML is invalid
*/
@ -99,9 +98,8 @@ class XmlFileLoader extends FileLoader
/**
* Parses a route and adds it to the RouteCollection.
*
* @param RouteCollection $collection RouteCollection instance
* @param \DOMElement $node Element to parse that represents a Route
* @param string $path Full path of the XML file being processed
* @param \DOMElement $node Element to parse that represents a Route
* @param string $path Full path of the XML file being processed
*
* @throws \InvalidArgumentException When the XML is invalid
*/
@ -140,10 +138,9 @@ class XmlFileLoader extends FileLoader
/**
* Parses an import and adds the routes in the resource to the RouteCollection.
*
* @param RouteCollection $collection RouteCollection instance
* @param \DOMElement $node Element to parse that represents a Route
* @param string $path Full path of the XML file being processed
* @param string $file Loaded file name
* @param \DOMElement $node Element to parse that represents a Route
* @param string $path Full path of the XML file being processed
* @param string $file Loaded file name
*
* @throws \InvalidArgumentException When the XML is invalid
*/

View File

@ -120,8 +120,7 @@ class UrlMatcher implements UrlMatcherInterface, RequestMatcherInterface
/**
* Tries to match a URL with a set of routes.
*
* @param string $pathinfo The path info to be parsed
* @param RouteCollection $routes The set of routes
* @param string $pathinfo The path info to be parsed
*
* @return array An array of parameters
*
@ -208,7 +207,6 @@ class UrlMatcher implements UrlMatcherInterface, RequestMatcherInterface
* in matchers that do not have access to the matched Route instance
* (like the PHP and Apache matcher dumpers).
*
* @param Route $route The route we are matching against
* @param string $name The name of the route
* @param array $attributes An array of attributes from the matcher
*
@ -231,7 +229,6 @@ class UrlMatcher implements UrlMatcherInterface, RequestMatcherInterface
*
* @param string $pathinfo The path
* @param string $name The route name
* @param Route $route The route
*
* @return array The first element represents the status, the second contains additional information
*/

View File

@ -259,8 +259,6 @@ class Route implements \Serializable
*
* This method implements a fluent interface.
*
* @param array $options The options
*
* @return $this
*/
public function setOptions(array $options)
@ -277,8 +275,6 @@ class Route implements \Serializable
*
* This method implements a fluent interface.
*
* @param array $options The options
*
* @return $this
*/
public function addOptions(array $options)

View File

@ -66,9 +66,6 @@ class RouteCollection implements \IteratorAggregate, \Countable
return \count($this->routes);
}
/**
* Adds a route.
*/
public function add(string $name, Route $route)
{
unset($this->routes[$name]);

View File

@ -115,8 +115,7 @@ class RouteCollectionBuilder
/**
* Add a RouteCollectionBuilder.
*
* @param string $prefix
* @param RouteCollectionBuilder $builder
* @param string $prefix
*/
public function mount($prefix, self $builder)
{
@ -127,7 +126,6 @@ class RouteCollectionBuilder
/**
* Adds a Route object to the builder.
*
* @param Route $route
* @param string|null $name
*
* @return $this

View File

@ -25,8 +25,6 @@ interface AuthenticationManagerInterface
/**
* Attempts to authenticate a TokenInterface object.
*
* @param TokenInterface $token The TokenInterface instance to authenticate
*
* @return TokenInterface An authenticated TokenInterface instance, never null
*
* @throws AuthenticationException if the authentication fails

View File

@ -24,9 +24,8 @@ class RememberMeToken extends AbstractToken
private $providerKey;
/**
* @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
* @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
*
* @throws \InvalidArgumentException
*/

View File

@ -21,11 +21,10 @@ class SwitchUserToken extends UsernamePasswordToken
private $originalToken;
/**
* @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
* @param string[] $roles An array of roles
* @param TokenInterface $originalToken The token of the user who switched to the current user
* @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
* @param string[] $roles An array of roles
*
* @throws \InvalidArgumentException
*/

View File

@ -70,9 +70,8 @@ class TraceableAccessDecisionManager implements AccessDecisionManagerInterface
/**
* Adds voter vote and class to the voter details.
*
* @param VoterInterface $voter voter
* @param array $attributes attributes used for the vote
* @param int $vote vote of the voter
* @param array $attributes attributes used for the vote
* @param int $vote vote of the voter
*/
public function addVoterVote(VoterInterface $voter, array $attributes, int $vote)
{

View File

@ -60,9 +60,8 @@ abstract class Voter implements VoterInterface
* Perform a single access check operation on a given attribute, subject and token.
* It is safe to assume that $attribute and $subject already passed the "supports()" method check.
*
* @param string $attribute
* @param mixed $subject
* @param TokenInterface $token
* @param string $attribute
* @param mixed $subject
*
* @return bool
*/

View File

@ -32,8 +32,7 @@ class SessionTokenStorage implements ClearableTokenStorageInterface
/**
* Initializes the storage with a Session object and a session namespace.
*
* @param SessionInterface $session The user session from which the session ID is returned
* @param string $namespace The namespace under which the token is stored in the session
* @param string $namespace The namespace under which the token is stored in the session
*/
public function __construct(SessionInterface $session, string $namespace = self::SESSION_NAMESPACE)
{

View File

@ -72,8 +72,7 @@ interface AuthenticatorInterface extends AuthenticationEntryPointInterface
* You may throw an AuthenticationException if you wish. If you return
* null, then a UsernameNotFoundException is thrown for you.
*
* @param mixed $credentials
* @param UserProviderInterface $userProvider
* @param mixed $credentials
*
* @throws AuthenticationException
*
@ -90,8 +89,7 @@ interface AuthenticatorInterface extends AuthenticationEntryPointInterface
*
* The *credentials* are the return value from getCredentials()
*
* @param mixed $credentials
* @param UserInterface $user
* @param mixed $credentials
*
* @return bool
*
@ -121,9 +119,6 @@ interface AuthenticatorInterface extends AuthenticationEntryPointInterface
* If you return null, the request will continue, but the user will
* not be authenticated. This is probably not what you want to do.
*
* @param Request $request
* @param AuthenticationException $exception
*
* @return Response|null
*/
public function onAuthenticationFailure(Request $request, AuthenticationException $exception);

View File

@ -27,9 +27,8 @@ class PostAuthenticationGuardToken extends AbstractToken implements GuardTokenIn
private $providerKey;
/**
* @param UserInterface $user The user!
* @param string $providerKey The provider (firewall) key
* @param string[] $roles An array of roles
* @param string $providerKey The provider (firewall) key
* @param string[] $roles An array of roles
*
* @throws \InvalidArgumentException
*/

View File

@ -40,8 +40,7 @@ class DefaultAuthenticationSuccessHandler implements AuthenticationSuccessHandle
];
/**
* @param HttpUtils $httpUtils
* @param array $options Options for processing a successful authentication attempt
* @param array $options Options for processing a successful authentication attempt
*/
public function __construct(HttpUtils $httpUtils, array $options = [])
{

View File

@ -40,9 +40,6 @@ interface AuthenticationEntryPointInterface
*
* return new Response('Auth header required', 401);
*
* @param Request $request The request that resulted in an AuthenticationException
* @param AuthenticationException $authException The exception that started the authentication process
*
* @return Response
*/
public function start(Request $request, AuthenticationException $authException = null);

View File

@ -73,8 +73,7 @@ class HttpUtils
/**
* Creates a Request.
*
* @param Request $request The current 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 Request A Request instance
*/

View File

@ -41,12 +41,11 @@ class LogoutUrlGenerator
/**
* Registers a firewall's LogoutListener, allowing its URL to be generated.
*
* @param string $key The firewall key
* @param string $logoutPath The path that starts the logout process
* @param string $csrfTokenId The ID of the CSRF token
* @param string $csrfParameter The CSRF token parameter name
* @param CsrfTokenManagerInterface|null $csrfTokenManager A CsrfTokenManagerInterface instance
* @param string|null $context The listener context
* @param string $key The firewall key
* @param string $logoutPath The path that starts the logout process
* @param string $csrfTokenId The ID of the CSRF token
* @param string $csrfParameter The CSRF token parameter name
* @param string|null $context The listener context
*/
public function registerListener($key, $logoutPath, $csrfTokenId, $csrfParameter, CsrfTokenManagerInterface $csrfTokenManager = null, string $context = null)
{

View File

@ -29,8 +29,7 @@ final class ParameterBagUtils
*
* Paths like foo[bar] will be evaluated to find deeper items in nested data structures.
*
* @param ParameterBag $parameters The parameter bag
* @param string $path The key
* @param string $path The key
*
* @return mixed
*
@ -64,8 +63,7 @@ final class ParameterBagUtils
*
* Paths like foo[bar] will be evaluated to find deeper items in nested data structures.
*
* @param Request $request The request
* @param string $path The key
* @param string $path The key
*
* @return mixed
*

View File

@ -51,8 +51,7 @@ class ClassMetadata implements ClassMetadataInterface
/**
* Constructs a metadata for the given class.
*
* @param string $class
* @param ClassDiscriminatorMapping|null $classDiscriminatorMapping
* @param string $class
*/
public function __construct(string $class, ClassDiscriminatorMapping $classDiscriminatorMapping = null)
{

View File

@ -60,8 +60,5 @@ interface ClassMetadataInterface
*/
public function getClassDiscriminatorMapping();
/**
* @param ClassDiscriminatorMapping|null $mapping
*/
public function setClassDiscriminatorMapping(ClassDiscriminatorMapping $mapping = null);
}

View File

@ -20,8 +20,6 @@ interface DenormalizerAwareInterface
{
/**
* Sets the owning Denormalizer object.
*
* @param DenormalizerInterface $denormalizer
*/
public function setDenormalizer(DenormalizerInterface $denormalizer);
}

View File

@ -20,8 +20,6 @@ interface NormalizerAwareInterface
{
/**
* Sets the owning Normalizer object.
*
* @param NormalizerInterface $normalizer
*/
public function setNormalizer(NormalizerInterface $normalizer);
}

View File

@ -234,9 +234,6 @@ class PhpEngine implements EngineInterface, \ArrayAccess
$this->addHelpers($helpers);
}
/**
* Sets a helper.
*/
public function set(HelperInterface $helper, string $alias = null)
{
$this->helpers[$helper->getName()] = $helper;

View File

@ -24,8 +24,7 @@ interface DumperInterface
/**
* Dumps the message catalogue.
*
* @param MessageCatalogue $messages The message catalogue
* @param array $options Options that are used by the dumper
* @param array $options Options that are used by the dumper
*/
public function dump(MessageCatalogue $messages, array $options = []);
}

View File

@ -30,8 +30,7 @@ class ChainExtractor implements ExtractorInterface
/**
* Adds a loader to the translation extractor.
*
* @param string $format The format of the loader
* @param ExtractorInterface $extractor The loader
* @param string $format The format of the loader
*/
public function addExtractor(string $format, ExtractorInterface $extractor)
{

View File

@ -24,8 +24,7 @@ interface ExtractorInterface
/**
* Extracts translation messages from files, a file or a directory to the catalogue.
*
* @param string|array $resource Files, a file or a directory
* @param MessageCatalogue $catalogue The catalogue
* @param string|array $resource Files, a file or a directory
*/
public function extract($resource, MessageCatalogue $catalogue);

View File

@ -73,9 +73,7 @@ class XliffFileLoader implements LoaderInterface
/**
* Extract messages and metadata from DOMDocument into a MessageCatalogue.
*
* @param \DOMDocument $dom Source to extract messages and metadata
* @param MessageCatalogue $catalogue Catalogue where we'll collect messages and metadata
* @param string $domain The domain
* @param string $domain The domain
*/
private function extractXliff1(\DOMDocument $dom, MessageCatalogue $catalogue, string $domain)
{

View File

@ -30,7 +30,6 @@ class LoggingTranslator implements TranslatorInterface, TranslatorBagInterface,
/**
* @param TranslatorInterface $translator The translator must implement TranslatorBagInterface
* @param LoggerInterface $logger
*/
public function __construct(TranslatorInterface $translator, LoggerInterface $logger)
{

View File

@ -32,8 +32,7 @@ class TranslationReader implements TranslationReaderInterface
/**
* Adds a loader to the translation extractor.
*
* @param string $format The format of the loader
* @param LoaderInterface $loader
* @param string $format The format of the loader
*/
public function addLoader(string $format, LoaderInterface $loader)
{

Some files were not shown because too many files have changed in this diff Show More