Merge branch '3.3' into 3.4

* 3.3:
  [CS] Apply phpdoc_annotation_without_dot
  bumped Symfony version to 3.3.10
  updated VERSION for 3.3.9
  updated CHANGELOG for 3.3.9
  [DomCrawler] Fix conversion to int on GetPhpFiles
  Remove `protected_to_private` rule.
  Filtering empty uuids in ORMQueryBuilderLoader.
This commit is contained in:
Fabien Potencier 2017-09-11 13:45:17 -07:00
commit 8cb614df9f
82 changed files with 347 additions and 214 deletions

View File

@ -12,7 +12,7 @@ return PhpCsFixer\Config::create()
'no_unreachable_default_argument_value' => false,
'braces' => array('allow_single_line_closure' => true),
'heredoc_to_nowdoc' => false,
'phpdoc_annotation_without_dot' => false,
'protected_to_private' => false,
))
->setRiskyAllowed(true)
->setFinder(

View File

@ -7,6 +7,23 @@ in 3.3 minor versions.
To get the diff for a specific change, go to https://github.com/symfony/symfony/commit/XXX where XXX is the change hash
To get the diff between two versions, go to https://github.com/symfony/symfony/compare/v3.3.0...v3.3.1
* 3.3.9 (2017-09-11)
* bug #24141 [DomCrawler] Fix conversion to int on GetPhpFiles (MaraBlaga)
* bug #23853 Filtering empty uuids in ORMQueryBuilderLoader. (mlazovla)
* bug #24101 [Security] Fix exception when use_referer option is true and referer is not set or empty (linniksa)
* bug #24105 [Filesystem] check permissions if dump target dir is missing (xabbuh)
* bug #24126 [HttpKernel] "controller.service_arguments" services should be public (nicolas-grekas)
* bug #24113 [FrameworkBundle] Get KERNEL_CLASS through $_ENV too for KernelTestCase (yceruto)
* bug #24115 [FrameworkBundle] Get KERNEL_DIR through $_ENV too for KernelTestCase (yceruto)
* bug #24041 [ExpressionLanguage] throws an exception on calling uncallable method (fmata)
* bug #24096 Fix ArrayInput::toString() for VALUE_IS_ARRAY options/args (chalasr)
* bug #24082 [DI] Minor fix in dumped code (nicolas-grekas)
* bug #23969 [Cache] Use namespace versioning for backends that dont support clearing by keys (nicolas-grekas)
* bug #24021 [DI] Don't track merged configs when the extension doesn't expose it (nicolas-grekas)
* bug #24011 [Cache] Always require symfony/polyfill-apcu to provide APCuIterator everywhere (guillaumelecerf)
* bug #23730 Fixed the escaping of back slashes and << in console output (javiereguiluz)
* 3.3.8 (2017-08-28)
* bug #24016 [DI] Fix tracking env var placeholders nested in object graphs (nicolas-grekas)

View File

@ -298,7 +298,7 @@ abstract class AbstractDoctrineExtension extends Extension
* @param ContainerBuilder $container A ContainerBuilder instance
* @param string $cacheName
*
* @throws \InvalidArgumentException In case of unknown driver type.
* @throws \InvalidArgumentException in case of unknown driver type
*/
protected function loadObjectManagerCacheDriver(array $objectManager, ContainerBuilder $container, $cacheName)
{

View File

@ -108,15 +108,15 @@ abstract class RegisterMappingsPass implements CompilerPassInterface
*
* @param Definition|Reference $driver Driver DI definition or reference
* @param string[] $namespaces List of namespaces handled by $driver
* @param string[] $managerParameters List of container parameters that could
* hold the manager name.
* @param string[] $managerParameters list of container parameters that could
* hold the manager name
* @param string $driverPattern Pattern for the metadata driver service name
* @param string|false $enabledParameter Service container parameter that must be
* present to enable the mapping. Set to false
* to not do any check, optional.
* @param string $configurationPattern Pattern for the Configuration service name
* @param string $registerAliasMethodName Name of Configuration class method to
* register alias.
* @param string $registerAliasMethodName name of Configuration class method to
* register alias
* @param string[] $aliasMap Map of alias to namespace
*/
public function __construct($driver, array $namespaces, array $managerParameters, $driverPattern, $enabledParameter = false, $configurationPattern = '', $registerAliasMethodName = '', array $aliasMap = array())
@ -174,7 +174,7 @@ abstract class RegisterMappingsPass implements CompilerPassInterface
* @return string The name of the chain driver service
*
* @throws InvalidArgumentException if non of the managerParameters has a
* non-empty value.
* non-empty value
*/
protected function getChainDriverServiceName(ContainerBuilder $container)
{
@ -185,7 +185,7 @@ abstract class RegisterMappingsPass implements CompilerPassInterface
* Create the service definition for the metadata driver.
*
* @param ContainerBuilder $container passed on in case an extending class
* needs access to the container.
* needs access to the container
*
* @return Definition|Reference the metadata driver to add to all chain drivers
*/
@ -202,7 +202,7 @@ abstract class RegisterMappingsPass implements CompilerPassInterface
* @return string a service definition name
*
* @throws InvalidArgumentException if none of the managerParameters has a
* non-empty value.
* non-empty value
*/
private function getConfigurationServiceName(ContainerBuilder $container)
{
@ -219,7 +219,7 @@ abstract class RegisterMappingsPass implements CompilerPassInterface
*
* @return string The name of the active manager
*
* @throws InvalidArgumentException If none of the managerParameters is found in the container.
* @throws InvalidArgumentException if none of the managerParameters is found in the container
*/
private function getManagerName(ContainerBuilder $container)
{

View File

@ -59,8 +59,8 @@ class DoctrineChoiceLoader implements ChoiceLoaderInterface
* @param ObjectManager $manager The object manager
* @param string $class The class name of the
* loaded objects
* @param IdReader $idReader The reader for the object
* IDs.
* @param IdReader $idReader the reader for the object
* IDs
* @param null|EntityLoaderInterface $objectLoader The objects loader
* @param ChoiceListFactoryInterface $factory The factory for creating
* the loaded choice list

View File

@ -79,8 +79,8 @@ class IdReader
/**
* Returns whether the class has a single-column ID.
*
* @return bool Returns `true` if the class has a single-column ID and
* `false` otherwise.
* @return bool returns `true` if the class has a single-column ID and
* `false` otherwise
*/
public function isSingleId()
{
@ -90,8 +90,8 @@ class IdReader
/**
* Returns whether the class has a single-column integer ID.
*
* @return bool Returns `true` if the class has a single-column integer ID
* and `false` otherwise.
* @return bool returns `true` if the class has a single-column integer ID
* and `false` otherwise
*/
public function isIntId()
{

View File

@ -72,7 +72,7 @@ class ORMQueryBuilderLoader implements EntityLoaderInterface
$values = array_values(array_filter($values, function ($v) {
return (string) $v === (string) (int) $v || ctype_digit($v);
}));
} elseif ('guid' === $metadata->getTypeOfField($identifier)) {
} elseif (in_array($metadata->getTypeOfField($identifier), array('uuid', 'guid'))) {
$parameterType = Connection::PARAM_STR_ARRAY;
// Like above, but we just filter out empty strings.

View File

@ -0,0 +1,28 @@
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Bridge\Doctrine\Tests\Fixtures;
use Doctrine\ORM\Mapping\Id;
use Doctrine\ORM\Mapping\Column;
use Doctrine\ORM\Mapping\Entity;
/** @Entity */
class GuidIdEntity
{
/** @Id @Column(type="guid") */
protected $id;
public function __construct($id)
{
$this->id = $id;
}
}

View File

@ -0,0 +1,28 @@
<?php
/*
* This file is part of the Symfony package.
*
* (c) Fabien Potencier <fabien@symfony.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Symfony\Bridge\Doctrine\Tests\Fixtures;
use Doctrine\ORM\Mapping\Id;
use Doctrine\ORM\Mapping\Column;
use Doctrine\ORM\Mapping\Entity;
/** @Entity */
class UuidIdEntity
{
/** @Id @Column(type="uuid") */
protected $id;
public function __construct($id)
{
$this->id = $id;
}
}

View File

@ -87,6 +87,38 @@ class ORMQueryBuilderLoaderTest extends TestCase
$loader->getEntitiesByIds('id', array(1, '', 2, 3, 'foo', '9223372036854775808'));
}
/**
* @dataProvider provideGuidEntityClasses
*/
public function testFilterEmptyUuids($entityClass)
{
$em = DoctrineTestHelper::createTestEntityManager();
$query = $this->getMockBuilder('QueryMock')
->setMethods(array('setParameter', 'getResult', 'getSql', '_doExecute'))
->getMock();
$query->expects($this->once())
->method('setParameter')
->with('ORMQueryBuilderLoader_getEntitiesByIds_id', array('71c5fd46-3f16-4abb-bad7-90ac1e654a2d', 'b98e8e11-2897-44df-ad24-d2627eb7f499'), Connection::PARAM_STR_ARRAY)
->willReturn($query);
$qb = $this->getMockBuilder('Doctrine\ORM\QueryBuilder')
->setConstructorArgs(array($em))
->setMethods(array('getQuery'))
->getMock();
$qb->expects($this->once())
->method('getQuery')
->willReturn($query);
$qb->select('e')
->from($entityClass, 'e');
$loader = new ORMQueryBuilderLoader($qb);
$loader->getEntitiesByIds('id', array('71c5fd46-3f16-4abb-bad7-90ac1e654a2d', '', 'b98e8e11-2897-44df-ad24-d2627eb7f499'));
}
public function testEmbeddedIdentifierName()
{
if (Version::compare('2.5.0') > 0) {
@ -120,4 +152,12 @@ class ORMQueryBuilderLoaderTest extends TestCase
$loader = new ORMQueryBuilderLoader($qb);
$loader->getEntitiesByIds('id.value', array(1, '', 2, 3, 'foo'));
}
public function provideGuidEntityClasses()
{
return array(
array('Symfony\Bridge\Doctrine\Tests\Fixtures\GuidIdEntity'),
array('Symfony\Bridge\Doctrine\Tests\Fixtures\UuidIdEntity'),
);
}
}

View File

@ -236,7 +236,7 @@ class FormHelper extends Helper
*
* @return string A CSRF token
*
* @throws \BadMethodCallException When no CSRF provider was injected in the constructor.
* @throws \BadMethodCallException when no CSRF provider was injected in the constructor
*/
public function csrfToken($tokenId)
{

View File

@ -39,7 +39,7 @@ abstract class BaseNode implements NodeInterface
* @param string $name The name of the node
* @param NodeInterface $parent The parent of this node
*
* @throws \InvalidArgumentException if the name contains a period.
* @throws \InvalidArgumentException if the name contains a period
*/
public function __construct($name, NodeInterface $parent = null)
{

View File

@ -154,10 +154,10 @@ class ArrayNodeDefinition extends NodeDefinition implements ParentNodeDefinition
/**
* Adds children with a default value when none are defined.
*
* @param int|string|array|null $children The number of children|The child name|The children names to be added
*
* This method is applicable to prototype nodes only.
*
* @param int|string|array|null $children the number of children|The child name|The children names to be added
*
* @return $this
*/
public function addDefaultChildrenIfNoneSet($children = null)

View File

@ -190,7 +190,7 @@ class Question
*
* @return $this
*
* @throws InvalidArgumentException In case the number of attempts is invalid.
* @throws InvalidArgumentException in case the number of attempts is invalid
*/
public function setMaxAttempts($attempts)
{

View File

@ -204,7 +204,7 @@ class DebugClassLoaderTest extends TestCase
$xError = array(
'type' => E_USER_DEPRECATED,
'message' => 'The "Test\Symfony\Component\Debug\Tests\\'.$class.'" class '.$type.' "Symfony\Component\Debug\Tests\Fixtures\\'.$super.'" that is deprecated but this is a test deprecation notice.',
'message' => 'The "Test\Symfony\Component\Debug\Tests\\'.$class.'" class '.$type.' "Symfony\Component\Debug\Tests\Fixtures\\'.$super.'" that is deprecated but this is a test deprecation notice',
);
$this->assertSame($xError, $lastError);

View File

@ -4,7 +4,7 @@ namespace Symfony\Component\Debug\Tests\Fixtures;
/**
* @deprecated but this is a test
* deprecation notice.
* deprecation notice
* @foobar
*/
class DeprecatedClass

View File

@ -4,7 +4,7 @@ namespace Symfony\Component\Debug\Tests\Fixtures;
/**
* @deprecated but this is a test
* deprecation notice.
* deprecation notice
* @foobar
*/
interface DeprecatedInterface

View File

@ -51,7 +51,7 @@ class CheckCircularReferencesPass implements CompilerPassInterface
*
* @param ServiceReferenceGraphEdge[] $edges An array of Edges
*
* @throws ServiceCircularReferenceException When a circular reference is found.
* @throws ServiceCircularReferenceException when a circular reference is found
*/
private function checkOutEdges(array $edges)
{

View File

@ -123,7 +123,7 @@ class Definition
*
* @return $this
*
* @throws InvalidArgumentException In case the decorated service id and the new decorated service id are equals.
* @throws InvalidArgumentException in case the decorated service id and the new decorated service id are equals
*/
public function setDecoratedService($id, $renamedId = null, $priority = 0)
{

View File

@ -169,7 +169,7 @@ class ParameterBag implements ParameterBagInterface
*
* @throws ParameterNotFoundException if a placeholder references a parameter that does not exist
* @throws ParameterCircularReferenceException if a circular reference if detected
* @throws RuntimeException when a given parameter has a type problem.
* @throws RuntimeException when a given parameter has a type problem
*/
public function resolveValue($value, array $resolving = array())
{
@ -199,7 +199,7 @@ class ParameterBag implements ParameterBagInterface
*
* @throws ParameterNotFoundException if a placeholder references a parameter that does not exist
* @throws ParameterCircularReferenceException if a circular reference if detected
* @throws RuntimeException when a given parameter has a type problem.
* @throws RuntimeException when a given parameter has a type problem
*/
public function resolveString($value, array $resolving = array())
{

View File

@ -107,7 +107,7 @@ class Crawler implements \Countable, \IteratorAggregate
*
* @param \DOMNodeList|\DOMNode|array|string|null $node A node
*
* @throws \InvalidArgumentException When node is not the expected type.
* @throws \InvalidArgumentException when node is not the expected type
*/
public function add($node)
{

View File

@ -172,6 +172,18 @@ class Form extends Link implements \ArrayAccess
if (!empty($qs)) {
parse_str($qs, $expandedValue);
$varName = substr($name, 0, strlen(key($expandedValue)));
array_walk_recursive(
$expandedValue,
function (&$value, $key) {
if (ctype_digit($value) && ('size' === $key || 'error' === $key)) {
$value = (int) $value;
}
}
);
reset($expandedValue);
$values = array_replace_recursive($values, array($varName => current($expandedValue)));
}
}

View File

@ -462,6 +462,15 @@ class FormTest extends TestCase
$form = $this->createForm('<form method="post"><input type="file" name="f.o o[bar][ba.z]" /><input type="file" name="f.o o[bar][]" /><input type="text" name="bar" value="bar" /><input type="submit" /></form>');
$this->assertEquals(array('f.o o' => array('bar' => array('ba.z' => array('name' => '', 'type' => '', 'tmp_name' => '', 'error' => 4, 'size' => 0), array('name' => '', 'type' => '', 'tmp_name' => '', 'error' => 4, 'size' => 0)))), $form->getPhpFiles(), '->getPhpFiles() preserves periods and spaces in names recursively');
$form = $this->createForm('<form method="post"><input type="file" name="foo[bar]" /><input type="text" name="bar" value="bar" /><input type="submit" /></form>');
$files = $form->getPhpFiles();
$this->assertSame(0, $files['foo']['bar']['size'], '->getPhpFiles() converts size to int');
$this->assertSame(4, $files['foo']['bar']['error'], '->getPhpFiles() converts error to int');
$form = $this->createForm('<form method="post"><input type="file" name="size[error]" /><input type="text" name="error" value="error" /><input type="submit" /></form>');
$this->assertEquals(array('size' => array('error' => array('name' => '', 'type' => '', 'tmp_name' => '', 'error' => 4, 'size' => 0))), $form->getPhpFiles(), '->getPhpFiles() int conversion does not collide with file names');
}
/**

View File

@ -26,8 +26,8 @@ interface EventDispatcherInterface
* @param string $eventName The name of the event to dispatch. The name of
* the event is the name of the method that is
* invoked on listeners.
* @param Event $event The event to pass to the event handlers/listeners
* If not supplied, an empty Event instance is created.
* @param Event $event the event to pass to the event handlers/listeners
* If not supplied, an empty Event instance is created
*
* @return Event
*/

View File

@ -63,7 +63,7 @@ class GenericEvent extends Event implements \ArrayAccess, \IteratorAggregate
*
* @return mixed Contents of array key
*
* @throws \InvalidArgumentException If key is not found.
* @throws \InvalidArgumentException if key is not found
*/
public function getArgument($key)
{
@ -132,7 +132,7 @@ class GenericEvent extends Event implements \ArrayAccess, \IteratorAggregate
*
* @return mixed
*
* @throws \InvalidArgumentException If key does not exist in $this->args.
* @throws \InvalidArgumentException if key does not exist in $this->args
*/
public function offsetGet($key)
{

View File

@ -659,7 +659,7 @@ class Filesystem
* @param string $filename The file to be written to
* @param string $content The data to write into the file
*
* @throws IOException If the file cannot be written to
* @throws IOException if the file cannot be written to
*/
public function dumpFile($filename, $content)
{

View File

@ -592,7 +592,7 @@ class Finder implements \IteratorAggregate, \Countable
*
* @return $this
*
* @throws \InvalidArgumentException When the given argument is not iterable.
* @throws \InvalidArgumentException when the given argument is not iterable
*/
public function append($iterator)
{

View File

@ -139,14 +139,14 @@ abstract class AbstractRendererEngine implements FormRendererEngineInterface
*
* @see getResourceForBlockHierarchy()
*
* @param string $cacheKey The cache key used for storing the
* resource.
* @param FormView $view The form view for finding the applying
* themes.
* @param array $blockNameHierarchy The block hierarchy, with the most
* specific block name at the end.
* @param int $hierarchyLevel The level in the block hierarchy that
* should be loaded.
* @param string $cacheKey the cache key used for storing the
* resource
* @param FormView $view the form view for finding the applying
* themes
* @param array $blockNameHierarchy the block hierarchy, with the most
* specific block name at the end
* @param int $hierarchyLevel the level in the block hierarchy that
* should be loaded
*
* @return bool True if the resource could be loaded, false otherwise
*/

View File

@ -371,7 +371,7 @@ class Button implements \IteratorAggregate, FormInterface
*
* @return $this
*
* @throws Exception\AlreadySubmittedException If the button has already been submitted.
* @throws Exception\AlreadySubmittedException if the button has already been submitted
*/
public function submit($submittedData, $clearMissing = true)
{

View File

@ -58,7 +58,7 @@ class ButtonBuilder implements \IteratorAggregate, FormBuilderInterface
* @param string $name The name of the button
* @param array $options The button's options
*
* @throws InvalidArgumentException If the name is empty.
* @throws InvalidArgumentException if the name is empty
*/
public function __construct($name, array $options = array())
{

View File

@ -216,8 +216,8 @@ class ArrayChoiceList implements ChoiceListInterface
* @param array $choices The choices
* @param array|null $cache The cache for previously checked entries. Internal
*
* @return bool Returns true if the choices can be cast to strings and
* false otherwise.
* @return bool returns true if the choices can be cast to strings and
* false otherwise
*/
private function castableToString(array $choices, array &$cache = array())
{

View File

@ -36,8 +36,8 @@ class ChoiceGroupView implements \IteratorAggregate
* Creates a new choice group view.
*
* @param string $label The label of the group
* @param ChoiceGroupView[]|ChoiceView[] $choices The choice views in the
* group.
* @param ChoiceGroupView[]|ChoiceView[] $choices the choice views in the
* group
*/
public function __construct($label, array $choices = array())
{

View File

@ -40,8 +40,8 @@ class ChoiceListView
* Creates a new choice list view.
*
* @param ChoiceGroupView[]|ChoiceView[] $choices The choice views
* @param ChoiceGroupView[]|ChoiceView[] $preferredChoices The preferred
* choice views.
* @param ChoiceGroupView[]|ChoiceView[] $preferredChoices the preferred
* choice views
*/
public function __construct(array $choices = array(), array $preferredChoices = array())
{

View File

@ -22,7 +22,7 @@ interface DataMapperInterface
* @param mixed $data Structured data
* @param FormInterface[]|\Traversable $forms A list of {@link FormInterface} instances
*
* @throws Exception\UnexpectedTypeException if the type of the data parameter is not supported.
* @throws Exception\UnexpectedTypeException if the type of the data parameter is not supported
*/
public function mapDataToForms($data, $forms);
@ -32,7 +32,7 @@ interface DataMapperInterface
* @param FormInterface[]|\Traversable $forms A list of {@link FormInterface} instances
* @param mixed $data Structured data
*
* @throws Exception\UnexpectedTypeException if the type of the data parameter is not supported.
* @throws Exception\UnexpectedTypeException if the type of the data parameter is not supported
*/
public function mapFormsToData($forms, &$data);
}

View File

@ -45,7 +45,7 @@ interface DataTransformerInterface
*
* @return mixed The value in the transformed representation
*
* @throws TransformationFailedException When the transformation fails.
* @throws TransformationFailedException when the transformation fails
*/
public function transform($value);
@ -71,7 +71,7 @@ interface DataTransformerInterface
*
* @return mixed The value in the original representation
*
* @throws TransformationFailedException When the transformation fails.
* @throws TransformationFailedException when the transformation fails
*/
public function reverseTransform($value);
}

View File

@ -46,7 +46,7 @@ class BooleanToStringTransformer implements DataTransformerInterface
*
* @return string String value
*
* @throws TransformationFailedException If the given value is not a Boolean.
* @throws TransformationFailedException if the given value is not a Boolean
*/
public function transform($value)
{
@ -68,7 +68,7 @@ class BooleanToStringTransformer implements DataTransformerInterface
*
* @return bool Boolean value
*
* @throws TransformationFailedException If the given value is not a string.
* @throws TransformationFailedException if the given value is not a string
*/
public function reverseTransform($value)
{

View File

@ -37,7 +37,7 @@ class ChoicesToValuesTransformer implements DataTransformerInterface
*
* @return array
*
* @throws TransformationFailedException If the given value is not an array.
* @throws TransformationFailedException if the given value is not an array
*/
public function transform($array)
{
@ -57,9 +57,9 @@ class ChoicesToValuesTransformer implements DataTransformerInterface
*
* @return array
*
* @throws TransformationFailedException If the given value is not an array
* @throws TransformationFailedException if the given value is not an array
* or if no matching choice could be
* found for some given value.
* found for some given value
*/
public function reverseTransform($array)
{

View File

@ -74,8 +74,8 @@ class DateTimeToLocalizedStringTransformer extends BaseDateTimeTransformer
*
* @return string|array Localized date string/array
*
* @throws TransformationFailedException If the given value is not a \DateTimeInterface
* or if the date could not be transformed.
* @throws TransformationFailedException if the given value is not a \DateTimeInterface
* or if the date could not be transformed
*/
public function transform($dateTime)
{
@ -151,11 +151,11 @@ class DateTimeToLocalizedStringTransformer extends BaseDateTimeTransformer
/**
* Returns a preconfigured IntlDateFormatter instance.
*
* @param bool $ignoreTimezone Use UTC regardless of the configured timezone.
* @param bool $ignoreTimezone use UTC regardless of the configured timezone
*
* @return \IntlDateFormatter
*
* @throws TransformationFailedException in case the date formatter can not be constructed.
* @throws TransformationFailedException in case the date formatter can not be constructed
*/
protected function getIntlDateFormatter($ignoreTimezone = false)
{

View File

@ -49,8 +49,8 @@ class MoneyToLocalizedStringTransformer extends NumberToLocalizedStringTransform
*
* @return string Localized money string
*
* @throws TransformationFailedException If the given value is not numeric or
* if the value can not be transformed.
* @throws TransformationFailedException if the given value is not numeric or
* if the value can not be transformed
*/
public function transform($value)
{
@ -72,8 +72,8 @@ class MoneyToLocalizedStringTransformer extends NumberToLocalizedStringTransform
*
* @return int|float Normalized number
*
* @throws TransformationFailedException If the given value is not a string
* or if the value can not be transformed.
* @throws TransformationFailedException if the given value is not a string
* or if the value can not be transformed
*/
public function reverseTransform($value)
{

View File

@ -100,8 +100,8 @@ class NumberToLocalizedStringTransformer implements DataTransformerInterface
*
* @return string Localized value
*
* @throws TransformationFailedException If the given value is not numeric
* or if the value can not be transformed.
* @throws TransformationFailedException if the given value is not numeric
* or if the value can not be transformed
*/
public function transform($value)
{
@ -133,8 +133,8 @@ class NumberToLocalizedStringTransformer implements DataTransformerInterface
*
* @return int|float The numeric value
*
* @throws TransformationFailedException If the given value is not a string
* or if the value can not be transformed.
* @throws TransformationFailedException if the given value is not a string
* or if the value can not be transformed
*/
public function reverseTransform($value)
{

View File

@ -70,8 +70,8 @@ class PercentToLocalizedStringTransformer implements DataTransformerInterface
*
* @return string Percentage value
*
* @throws TransformationFailedException If the given value is not numeric or
* if the value could not be transformed.
* @throws TransformationFailedException if the given value is not numeric or
* if the value could not be transformed
*/
public function transform($value)
{
@ -105,8 +105,8 @@ class PercentToLocalizedStringTransformer implements DataTransformerInterface
*
* @return int|float Normalized value
*
* @throws TransformationFailedException If the given value is not a string or
* if the value could not be transformed.
* @throws TransformationFailedException if the given value is not a string or
* if the value could not be transformed
*/
public function reverseTransform($value)
{

View File

@ -51,8 +51,8 @@ class ValueToDuplicatesTransformer implements DataTransformerInterface
*
* @return mixed The value
*
* @throws TransformationFailedException If the given value is not an array or
* if the given array can not be transformed.
* @throws TransformationFailedException if the given value is not an array or
* if the given array can not be transformed
*/
public function reverseTransform($array)
{

View File

@ -38,10 +38,10 @@ class MergeCollectionListener implements EventSubscriberInterface
/**
* Creates a new listener.
*
* @param bool $allowAdd Whether values might be added to the
* collection.
* @param bool $allowDelete Whether values might be removed from the
* collection.
* @param bool $allowAdd whether values might be added to the
* collection
* @param bool $allowDelete whether values might be removed from the
* collection
*/
public function __construct($allowAdd = false, $allowDelete = false)
{

View File

@ -250,8 +250,8 @@ class ValidatorTypeGuesser implements FormTypeGuesserInterface
* @param string $property The property for which to find constraints
* @param \Closure $closure The closure that returns a guess
* for a given constraint
* @param mixed $defaultValue The default value assumed if no other value
* can be guessed.
* @param mixed $defaultValue the default value assumed if no other value
* can be guessed
*
* @return Guess|null The guessed value with the highest confidence
*/

View File

@ -24,10 +24,10 @@ interface ViolationMapperInterface
* 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 FormInterface $form the root form of the tree
* to map it to
* @param bool $allowNonSynchronized whether to allow
* mapping to non-synchronized forms
*/
public function mapViolation(ConstraintViolation $violation, FormInterface $form, $allowNonSynchronized = false);
}

View File

@ -48,8 +48,8 @@ class ViolationPath implements \IteratorAggregate, PropertyPathInterface
/**
* Creates a new violation path from a string.
*
* @param string $violationPath The property path of a {@link \Symfony\Component\Validator\ConstraintViolation}
* object.
* @param string $violationPath the property path of a {@link \Symfony\Component\Validator\ConstraintViolation}
* object
*/
public function __construct($violationPath)
{
@ -210,7 +210,7 @@ class ViolationPath implements \IteratorAggregate, PropertyPathInterface
*
* @return bool Whether the element maps to a form
*
* @throws OutOfBoundsException If the offset is invalid.
* @throws OutOfBoundsException if the offset is invalid
*/
public function mapsForm($index)
{

View File

@ -944,7 +944,7 @@ class Form implements \IteratorAggregate, FormInterface
*
* @return FormInterface The child form
*
* @throws \OutOfBoundsException If the named child does not exist.
* @throws \OutOfBoundsException if the named child does not exist
*/
public function offsetGet($name)
{
@ -957,8 +957,8 @@ class Form implements \IteratorAggregate, FormInterface
* @param string $name Ignored. The name of the child is used
* @param FormInterface $child The child to be added
*
* @throws AlreadySubmittedException If the form has already been submitted.
* @throws LogicException When trying to add a child to a non-compound form.
* @throws AlreadySubmittedException if the form has already been submitted
* @throws LogicException when trying to add a child to a non-compound form
*
* @see self::add()
*/
@ -972,7 +972,7 @@ class Form implements \IteratorAggregate, FormInterface
*
* @param string $name The name of the child to remove
*
* @throws AlreadySubmittedException If the form has already been submitted.
* @throws AlreadySubmittedException if the form has already been submitted
*/
public function offsetUnset($name)
{

View File

@ -185,8 +185,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
* @param EventDispatcherInterface $dispatcher The event dispatcher
* @param array $options The form options
*
* @throws InvalidArgumentException If the data class is not a valid class or if
* the name contains invalid characters.
* @throws InvalidArgumentException if the data class is not a valid class or if
* the name contains invalid characters
*/
public function __construct($name, $dataClass, EventDispatcherInterface $dispatcher, array $options = array())
{
@ -852,8 +852,8 @@ class FormConfigBuilder implements FormConfigBuilderInterface
*
* @param string|int $name The tested form name
*
* @throws UnexpectedTypeException If the name is not a string or an integer.
* @throws InvalidArgumentException If the name contains invalid characters.
* @throws UnexpectedTypeException if the name is not a string or an integer
* @throws InvalidArgumentException if the name contains invalid characters
*/
public static function validateName($name)
{

View File

@ -152,9 +152,8 @@ interface FormConfigBuilderInterface extends FormConfigInterface
/**
* Sets the property path that the form should be mapped to.
*
* @param null|string|PropertyPathInterface $propertyPath
* The property path or null if the path should be set
* automatically based on the form's name.
* @param null|string|PropertyPathInterface $propertyPath the property path or null if the path should be set
* automatically based on the form's name
*
* @return $this The configuration object
*/
@ -173,8 +172,8 @@ interface FormConfigBuilderInterface extends FormConfigInterface
/**
* Sets whether the form's data should be modified by reference.
*
* @param bool $byReference Whether the data should be
* modified by reference.
* @param bool $byReference whether the data should be
* modified by reference
*
* @return $this The configuration object
*/

View File

@ -213,8 +213,8 @@ interface FormConfigInterface
/**
* Returns whether the form should be initialized upon creation.
*
* @return bool Returns true if the form should be initialized
* when created, false otherwise.
* @return bool returns true if the form should be initialized
* when created, false otherwise
*/
public function getAutoInitialize();

View File

@ -108,8 +108,8 @@ class FormErrorIterator implements \RecursiveIterator, \SeekableIterator, \Array
/**
* Returns the current element of the iterator.
*
* @return FormError|FormErrorIterator An error or an iterator containing
* nested errors.
* @return FormError|FormErrorIterator an error or an iterator containing
* nested errors
*/
public function current()
{

View File

@ -27,9 +27,9 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
*
* @return self
*
* @throws Exception\AlreadySubmittedException If the form has already been submitted.
* @throws Exception\LogicException When trying to set a parent for a form with
* an empty name.
* @throws Exception\AlreadySubmittedException if the form has already been submitted
* @throws Exception\LogicException when trying to set a parent for a form with
* an empty name
*/
public function setParent(FormInterface $parent = null);
@ -49,9 +49,9 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
*
* @return self
*
* @throws Exception\AlreadySubmittedException If the form has already been submitted.
* @throws Exception\LogicException When trying to add a child to a non-compound form.
* @throws Exception\UnexpectedTypeException If $child or $type has an unexpected type.
* @throws Exception\AlreadySubmittedException if the form has already been submitted
* @throws Exception\LogicException when trying to add a child to a non-compound form
* @throws Exception\UnexpectedTypeException if $child or $type has an unexpected type
*/
public function add($child, $type = null, array $options = array());
@ -62,7 +62,7 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
*
* @return self
*
* @throws \OutOfBoundsException If the named child does not exist.
* @throws \OutOfBoundsException if the named child does not exist
*/
public function get($name);
@ -82,7 +82,7 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
*
* @return $this
*
* @throws Exception\AlreadySubmittedException If the form has already been submitted.
* @throws Exception\AlreadySubmittedException if the form has already been submitted
*/
public function remove($name);
@ -112,7 +112,7 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
*
* @return $this
*
* @throws Exception\AlreadySubmittedException If the form has already been submitted.
* @throws Exception\AlreadySubmittedException if the form has already been submitted
* @throws Exception\LogicException If listeners try to call setData in a cycle. Or if
* the view data does not match the expected type
* according to {@link FormConfigInterface::getDataClass}.
@ -129,7 +129,7 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
/**
* Returns the normalized data of the field.
*
* @return mixed When the field is not submitted, the default data is returned
* @return mixed When the field is not submitted, the default data is returned.
* When the field is submitted, the normalized submitted data is
* returned if the field is valid, null otherwise.
*/
@ -270,13 +270,13 @@ interface FormInterface extends \ArrayAccess, \Traversable, \Countable
* Submits data to the form, transforms and validates it.
*
* @param null|string|array $submittedData The submitted data
* @param bool $clearMissing Whether to set fields to NULL
* @param bool $clearMissing whether to set fields to NULL
* when they are missing in the
* submitted data.
* submitted data
*
* @return $this
*
* @throws Exception\AlreadySubmittedException If the form has already been submitted.
* @throws Exception\AlreadySubmittedException if the form has already been submitted
*/
public function submit($submittedData, $clearMissing = true);

View File

@ -36,13 +36,13 @@ interface FormRendererEngineInterface
* The type of the resource is decided by the implementation. The resource
* is later passed to {@link renderBlock()} by the rendering algorithm.
*
* @param FormView $view The view for determining the used themes
* @param FormView $view The view for determining the used themes.
* First the themes attached directly to the
* view with {@link setTheme()} are considered,
* then the ones of its parent etc.
* @param string $blockName The name of the block to render
* @param string $blockName the name of the block to render
*
* @return mixed The renderer resource or false, if none was found
* @return mixed the renderer resource or false, if none was found
*/
public function getResourceForBlockName(FormView $view, $blockName);
@ -70,12 +70,12 @@ interface FormRendererEngineInterface
* The type of the resource is decided by the implementation. The resource
* is later passed to {@link renderBlock()} by the rendering algorithm.
*
* @param FormView $view The view for determining the used themes
* @param FormView $view The view for determining the used themes.
* First the themes attached directly to
* the view with {@link setTheme()} are
* considered, then the ones of its parent etc.
* @param array $blockNameHierarchy The block name hierarchy, with the root block
* at the beginning.
* @param array $blockNameHierarchy the block name hierarchy, with the root block
* at the beginning
* @param int $hierarchyLevel The level in the hierarchy at which to start
* looking. Level 0 indicates the root block, i.e.
* the first element of $blockNameHierarchy.
@ -110,12 +110,12 @@ interface FormRendererEngineInterface
* The type of the resource is decided by the implementation. The resource
* is later passed to {@link renderBlock()} by the rendering algorithm.
*
* @param FormView $view The view for determining the used themes
* @param FormView $view The view for determining the used themes.
* First the themes attached directly to
* the view with {@link setTheme()} are
* considered, then the ones of its parent etc.
* @param array $blockNameHierarchy The block name hierarchy, with the root block
* at the beginning.
* @param array $blockNameHierarchy the block name hierarchy, with the root block
* at the beginning
* @param int $hierarchyLevel The level in the hierarchy at which to start
* looking. Level 0 indicates the root block, i.e.
* the first element of $blockNameHierarchy.

View File

@ -39,7 +39,7 @@ class SubmitButton extends Button implements ClickableInterface
*
* @return $this
*
* @throws Exception\AlreadySubmittedException If the form has already been submitted.
* @throws Exception\AlreadySubmittedException if the form has already been submitted
*/
public function submit($submittedData, $clearMissing = true)
{

View File

@ -58,10 +58,10 @@ class OrderedHashMapIterator implements \Iterator
/**
* Creates a new iterator.
*
* @param array $elements The elements of the map, indexed by their
* keys.
* @param array $orderedKeys The keys of the map in the order in which
* they should be iterated.
* @param array $elements the elements of the map, indexed by their
* keys
* @param array $orderedKeys the keys of the map in the order in which
* they should be iterated
* @param array $managedCursors An array from which to reference the
* iterator's cursor as long as it is alive.
* This array is managed by the corresponding

View File

@ -445,12 +445,12 @@ class Response
/**
* Sets the response status code.
*
* @param int $code HTTP status code
* @param mixed $text HTTP status text
*
* If the status text is null it will be automatically populated for the known
* status codes and left empty otherwise.
*
* @param int $code HTTP status code
* @param mixed $text HTTP status text
*
* @return $this
*
* @throws \InvalidArgumentException When the HTTP status code is not valid

View File

@ -25,7 +25,7 @@ interface SessionInterface
*
* @return bool True if session started
*
* @throws \RuntimeException If session fails to start.
* @throws \RuntimeException if session fails to start
*/
public function start();

View File

@ -26,7 +26,7 @@ interface SessionStorageInterface
*
* @return bool True if started
*
* @throws \RuntimeException If something goes wrong starting the session.
* @throws \RuntimeException if something goes wrong starting the session
*/
public function start();
@ -104,8 +104,8 @@ interface SessionStorageInterface
* a real PHP session would interfere with testing, in which case
* it should actually persist the session data if required.
*
* @throws \RuntimeException If the session is saved without being started, or if the session
* is already closed.
* @throws \RuntimeException if the session is saved without being started, or if the session
* is already closed
*/
public function save();

View File

@ -51,7 +51,7 @@ class FragmentListener implements EventSubscriberInterface
*
* @param GetResponseEvent $event A GetResponseEvent instance
*
* @throws AccessDeniedHttpException if the request does not come from a trusted IP.
* @throws AccessDeniedHttpException if the request does not come from a trusted IP
*/
public function onKernelRequest(GetResponseEvent $event)
{

View File

@ -34,7 +34,7 @@ class GenrbCompiler implements BundleCompilerInterface
* @param string $envVars Optional. Environment variables to be loaded when
* running "genrb".
*
* @throws RuntimeException If the "genrb" cannot be found.
* @throws RuntimeException if the "genrb" cannot be found
*/
public function __construct($genrb = 'genrb', $envVars = '')
{

View File

@ -31,8 +31,8 @@ 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, $bufferSize)
{

View File

@ -46,8 +46,8 @@ interface BundleEntryReaderInterface extends BundleReaderInterface
* (i.e. array or \ArrayAccess) or cannot be found
* in the requested locale.
*
* @return mixed Returns an array or {@link \ArrayAccess} instance for
* complex data and a scalar value for simple data.
* @return mixed returns an array or {@link \ArrayAccess} instance for
* complex data and a scalar value for simple data
*
* @throws MissingResourceException If the indices cannot be accessed
*/

View File

@ -26,8 +26,8 @@ interface BundleReaderInterface
* @param string $path The path to the resource bundle
* @param string $locale The locale to read
*
* @return mixed Returns an array or {@link \ArrayAccess} instance for
* complex data, a scalar value otherwise.
* @return mixed returns an array or {@link \ArrayAccess} instance for
* complex data, a scalar value otherwise
*/
public function read($path, $locale);
}

View File

@ -46,8 +46,8 @@ class TextBundleWriter implements BundleWriterInterface
* @param resource $file The file handle to write to
* @param string $bundleName The name of the bundle
* @param mixed $value The value of the node
* @param bool $fallback Whether the resource bundle should be merged
* with the fallback locale.
* @param bool $fallback whether the resource bundle should be merged
* with the fallback locale
*
* @see http://source.icu-project.org/repos/icu/icuhtml/trunk/design/bnf_rb.txt
*/
@ -66,8 +66,8 @@ class TextBundleWriter implements BundleWriterInterface
* @param resource $file The file handle to write to
* @param mixed $value The value of the node
* @param int $indentation The number of levels to indent
* @param bool $requireBraces Whether to require braces to be printed
* around the value.
* @param bool $requireBraces whether to require braces to be printed
* around the value
*
* @see http://source.icu-project.org/repos/icu/icuhtml/trunk/design/bnf_rb.txt
*/
@ -153,8 +153,8 @@ class TextBundleWriter implements BundleWriterInterface
*
* @param resource $file The file handle to write to
* @param string $value The value of the node
* @param bool $requireBraces Whether to require braces to be printed
* around the value.
* @param bool $requireBraces whether to require braces to be printed
* around the value
*
* @see http://source.icu-project.org/repos/icu/icuhtml/trunk/design/bnf_rb.txt
*/
@ -199,11 +199,11 @@ class TextBundleWriter implements BundleWriterInterface
* @param resource $file The file handle to write to
* @param array|\Traversable $value The value of the node
* @param int $indentation The number of levels to indent
* @param bool $fallback Whether the table should be merged
* with the fallback locale.
* @param bool $fallback whether the table should be merged
* with the fallback locale
*
* @throws UnexpectedTypeException When $value is not an array and not a
* \Traversable instance.
* @throws UnexpectedTypeException when $value is not an array and not a
* \Traversable instance
*/
private function writeTable($file, $value, $indentation, $fallback = true)
{

View File

@ -169,8 +169,8 @@ class IntlDateFormatter
* @param int $datetype Type of date formatting, one of the format type constants
* @param int $timetype Type of time formatting, one of the format type constants
* @param string $timezone Timezone identifier
* @param int $calendar Calendar to use for formatting or parsing; default is Gregorian
* One of the calendar constants.
* @param int $calendar calendar to use for formatting or parsing; default is Gregorian
* One of the calendar constants
* @param string $pattern Optional pattern to use when formatting
*
* @return self
@ -519,7 +519,7 @@ class IntlDateFormatter
/**
* Set the formatter's timezone identifier.
*
* @param string $timeZoneId The time zone ID string of the time zone to use
* @param string $timeZoneId The time zone ID string of the time zone to use.
* If NULL or the empty string, the default time zone for the
* runtime is used.
*

View File

@ -260,7 +260,7 @@ class NumberFormatter
* Constructor.
*
* @param string $locale The locale code. The only currently supported locale is "en" (or null using the default locale, i.e. "en")
* @param int $style Style of the formatting, one of the format style constants
* @param int $style Style of the formatting, one of the format style constants.
* The only supported styles are NumberFormatter::DECIMAL
* and NumberFormatter::CURRENCY.
* @param string $pattern Not supported. A pattern string in case $style is NumberFormat::PATTERN_DECIMAL or
@ -297,7 +297,7 @@ class NumberFormatter
* Static constructor.
*
* @param string $locale The locale code. The only supported locale is "en" (or null using the default locale, i.e. "en")
* @param int $style Style of the formatting, one of the format style constants
* @param int $style Style of the formatting, one of the format style constants.
* The only currently supported styles are NumberFormatter::DECIMAL
* and NumberFormatter::CURRENCY.
* @param string $pattern Not supported. A pattern string in case $style is NumberFormat::PATTERN_DECIMAL or
@ -357,8 +357,8 @@ class NumberFormatter
/**
* Format a number.
*
* @param int|float $value The value to format
* @param int $type Type of the formatting, one of the format type constants
* @param int|float $value the value to format
* @param int $type Type of the formatting, one of the format type constants.
* Only type NumberFormatter::TYPE_DEFAULT is currently supported.
*
* @return bool|string The formatted value or false on error
@ -518,9 +518,9 @@ class NumberFormatter
/**
* Parse a number.
*
* @param string $value The value to parse
* @param int $type Type of the formatting, one of the format type constants. NumberFormatter::TYPE_DOUBLE by default
* @param int $position Offset to begin the parsing on return this value will hold the offset at which the parsing ended
* @param string $value the value to parse
* @param int $type Type of the formatting, one of the format type constants. NumberFormatter::TYPE_DOUBLE by default.
* @param int $position offset to begin the parsing on return this value will hold the offset at which the parsing ended
*
* @return int|float|false The parsed value of false on error
*
@ -568,10 +568,10 @@ class NumberFormatter
/**
* Set an attribute.
*
* @param int $attr An attribute specifier, one of the numeric attribute constants
* @param int $attr An attribute specifier, one of the numeric attribute constants.
* The only currently supported attributes are NumberFormatter::FRACTION_DIGITS,
* NumberFormatter::GROUPING_USED and NumberFormatter::ROUNDING_MODE.
* @param int $value The attribute value
* @param int $value the attribute value
*
* @return bool true on success or false on failure
*

View File

@ -84,8 +84,8 @@ class IcuVersion
* @param int|null $precision The number of components to include. Pass
* NULL to return the version unchanged.
*
* @return string|null The normalized ICU version or NULL if it couldn't be
* normalized.
* @return string|null the normalized ICU version or NULL if it couldn't be
* normalized
*/
public static function normalize($version, $precision)
{

View File

@ -26,8 +26,8 @@ class SvnCommit
/**
* Creates a commit from the given "svn info" data.
*
* @param \SimpleXMLElement $svnInfo The XML result from the "svn info"
* command.
* @param \SimpleXMLElement $svnInfo the XML result from the "svn info"
* command
*/
public function __construct(\SimpleXMLElement $svnInfo)
{

View File

@ -44,7 +44,7 @@ class SvnRepository
*
* @return static
*
* @throws RuntimeException If an error occurs during the download.
* @throws RuntimeException if an error occurs during the download
*/
public static function download($url, $targetDir)
{
@ -119,7 +119,7 @@ class SvnRepository
*
* @return \SimpleXMLElement The XML result from the "svn info" command
*
* @throws RuntimeException If the "svn info" command failed.
* @throws RuntimeException if the "svn info" command failed
*/
private function getSvnInfo()
{

View File

@ -67,8 +67,8 @@ class Version
* @param int|null $precision The number of components to include. Pass
* NULL to return the version unchanged.
*
* @return string|null The normalized version or NULL if it couldn't be
* normalized.
* @return string|null the normalized version or NULL if it couldn't be
* normalized
*/
public static function normalize($version, $precision)
{

View File

@ -1684,7 +1684,7 @@ class Process implements \IteratorAggregate
*
* @param string $functionName The function name that was called
*
* @throws LogicException If the process has not run.
* @throws LogicException if the process has not run
*/
private function requireProcessIsStarted($functionName)
{
@ -1698,7 +1698,7 @@ class Process implements \IteratorAggregate
*
* @param string $functionName The function name that was called
*
* @throws LogicException If the process is not yet terminated.
* @throws LogicException if the process is not yet terminated
*/
private function requireProcessIsTerminated($functionName)
{

View File

@ -352,7 +352,7 @@ class PropertyAccessor implements PropertyAccessorInterface
*
* @return array The values read in the path
*
* @throws UnexpectedTypeException If a value within the path is neither object nor array.
* @throws UnexpectedTypeException if a value within the path is neither object nor array
* @throws NoSuchIndexException If a non-existing index is accessed
*/
private function readPropertiesUntil($zval, PropertyPathInterface $propertyPath, $lastIndex, $ignoreInvalidIndices = true)
@ -470,7 +470,7 @@ class PropertyAccessor implements PropertyAccessorInterface
*
* @return array The array containing the value of the property
*
* @throws NoSuchPropertyException If the property does not exist or is not public.
* @throws NoSuchPropertyException if the property does not exist or is not public
*/
private function readProperty($zval, $property)
{
@ -621,7 +621,7 @@ class PropertyAccessor implements PropertyAccessorInterface
* @param string $property The property to write
* @param mixed $value The value to write
*
* @throws NoSuchPropertyException If the property does not exist or is not public.
* @throws NoSuchPropertyException if the property does not exist or is not public
*/
private function writeProperty($zval, $property, $value)
{

View File

@ -45,10 +45,10 @@ class PropertyPathBuilder
* Appends a (sub-) path to the current path.
*
* @param PropertyPathInterface|string $path The path to append
* @param int $offset The offset where the appended
* piece starts in $path.
* @param int $length The length of the appended piece
* If 0, the full path is appended.
* @param int $offset the offset where the appended
* piece starts in $path
* @param int $length the length of the appended piece
* If 0, the full path is appended
*/
public function append($path, $offset = 0, $length = 0)
{
@ -113,10 +113,10 @@ class PropertyPathBuilder
* @param int $offset The offset at which to replace
* @param int $length The length of the piece to replace
* @param PropertyPathInterface|string $path The path to insert
* @param int $pathOffset The offset where the inserted piece
* starts in $path.
* @param int $pathLength The length of the inserted piece
* If 0, the full path is inserted.
* @param int $pathOffset the offset where the inserted piece
* starts in $path
* @param int $pathLength the length of the inserted piece
* If 0, the full path is inserted
*
* @throws OutOfBoundsException If the offset is invalid
*/

View File

@ -36,8 +36,8 @@ class XmlFileLoader extends FileLoader
*
* @return RouteCollection A RouteCollection instance
*
* @throws \InvalidArgumentException When the file cannot be loaded or when the XML cannot be
* parsed because it does not validate against the scheme.
* @throws \InvalidArgumentException when the file cannot be loaded or when the XML cannot be
* parsed because it does not validate against the scheme
*/
public function load($file, $type = null)
{

View File

@ -39,10 +39,10 @@ class RouteCompiler implements RouteCompilerInterface
/**
* {@inheritdoc}
*
* @throws \InvalidArgumentException If a path variable is named _fragment
* @throws \LogicException If a variable is referenced more than once
* @throws \DomainException If a variable name starts with a digit or if it is too long to be successfully used as
* a PCRE subpattern.
* @throws \InvalidArgumentException if a path variable is named _fragment
* @throws \LogicException if a variable is referenced more than once
* @throws \DomainException if a variable name starts with a digit or if it is too long to be successfully used as
* a PCRE subpattern
*/
public static function compile(Route $route)
{

View File

@ -49,7 +49,7 @@ class AuthorizationChecker implements AuthorizationCheckerInterface
/**
* {@inheritdoc}
*
* @throws AuthenticationCredentialsNotFoundException when the token storage has no authentication token.
* @throws AuthenticationCredentialsNotFoundException when the token storage has no authentication token
*/
final public function isGranted($attributes, $subject = null)
{

View File

@ -101,7 +101,7 @@ class InMemoryUserProvider implements UserProviderInterface
*
* @return User
*
* @throws UsernameNotFoundException If user whose given username does not exist.
* @throws UsernameNotFoundException if user whose given username does not exist
*/
private function getUser($username)
{

View File

@ -64,7 +64,7 @@ class ChainDecoder implements DecoderInterface /*, ContextAwareDecoderInterface*
*
* @return DecoderInterface
*
* @throws RuntimeException If no decoder is found.
* @throws RuntimeException if no decoder is found
*/
private function getDecoder($format, array $context)
{

View File

@ -27,11 +27,11 @@ interface NormalizableInterface
* It is important to understand that the normalize() call should normalize
* recursively all child objects of the implementor.
*
* @param NormalizerInterface $normalizer The normalizer is given so that you
* can use it to normalize objects contained within this object.
* @param string|null $format The format is optionally given to be able to normalize differently
* based on different output formats.
* @param array $context Options for normalizing this object
* @param NormalizerInterface $normalizer the normalizer is given so that you
* can use it to normalize objects contained within this object
* @param string|null $format the format is optionally given to be able to normalize differently
* based on different output formats
* @param array $context options for normalizing this object
*
* @return array|scalar
*/

View File

@ -209,7 +209,7 @@ abstract class Constraint
*
* @throws InvalidOptionsException If an invalid option name is given
*
* @internal This method should not be used or overwritten in userland code.
* @internal this method should not be used or overwritten in userland code
*/
public function __get($option)
{

View File

@ -56,8 +56,8 @@ interface ConstraintViolationInterface
/**
* Returns the parameters to be inserted into the raw violation message.
*
* @return array A possibly empty list of parameters indexed by the names
* that appear in the message template.
* @return array a possibly empty list of parameters indexed by the names
* that appear in the message template
*
* @see getMessageTemplate()
*/
@ -108,8 +108,8 @@ interface ConstraintViolationInterface
/**
* Returns the value that caused the violation.
*
* @return mixed The invalid value that caused the validated constraint to
* fail.
* @return mixed the invalid value that caused the validated constraint to
* fail
*/
public function getInvalidValue();

View File

@ -39,7 +39,7 @@ interface ConstraintViolationListInterface extends \Traversable, \Countable, \Ar
*
* @return ConstraintViolationInterface The violation
*
* @throws \OutOfBoundsException If the offset does not exist.
* @throws \OutOfBoundsException if the offset does not exist
*/
public function get($offset);