Update Composer, update everything
This commit is contained in:
Oliver Davies
parent
ea3e94409f
commit
dda5c284b6
19527 changed files with 1135420 additions and 351004 deletions
351
vendor/symfony/validator/Context/ExecutionContext.php
vendored
Normal file
351
vendor/symfony/validator/Context/ExecutionContext.php
vendored
Normal file
|
|
@ -0,0 +1,351 @@
|
|||
<?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\Component\Validator\Context;
|
||||
|
||||
use Symfony\Component\Translation\TranslatorInterface;
|
||||
use Symfony\Component\Validator\Constraint;
|
||||
use Symfony\Component\Validator\ConstraintViolation;
|
||||
use Symfony\Component\Validator\ConstraintViolationList;
|
||||
use Symfony\Component\Validator\Mapping\ClassMetadataInterface;
|
||||
use Symfony\Component\Validator\Mapping\MemberMetadata;
|
||||
use Symfony\Component\Validator\Mapping\MetadataInterface;
|
||||
use Symfony\Component\Validator\Mapping\PropertyMetadataInterface;
|
||||
use Symfony\Component\Validator\Util\PropertyPath;
|
||||
use Symfony\Component\Validator\Validator\ValidatorInterface;
|
||||
use Symfony\Component\Validator\Violation\ConstraintViolationBuilder;
|
||||
|
||||
/**
|
||||
* The context used and created by {@link ExecutionContextFactory}.
|
||||
*
|
||||
* @author Bernhard Schussek <bschussek@gmail.com>
|
||||
*
|
||||
* @see ExecutionContextInterface
|
||||
*
|
||||
* @internal since version 2.5. Code against ExecutionContextInterface instead.
|
||||
*/
|
||||
class ExecutionContext implements ExecutionContextInterface
|
||||
{
|
||||
/**
|
||||
* @var ValidatorInterface
|
||||
*/
|
||||
private $validator;
|
||||
|
||||
/**
|
||||
* The root value of the validated object graph.
|
||||
*
|
||||
* @var mixed
|
||||
*/
|
||||
private $root;
|
||||
|
||||
/**
|
||||
* @var TranslatorInterface
|
||||
*/
|
||||
private $translator;
|
||||
|
||||
/**
|
||||
* @var string
|
||||
*/
|
||||
private $translationDomain;
|
||||
|
||||
/**
|
||||
* The violations generated in the current context.
|
||||
*
|
||||
* @var ConstraintViolationList
|
||||
*/
|
||||
private $violations;
|
||||
|
||||
/**
|
||||
* The currently validated value.
|
||||
*
|
||||
* @var mixed
|
||||
*/
|
||||
private $value;
|
||||
|
||||
/**
|
||||
* The currently validated object.
|
||||
*
|
||||
* @var object|null
|
||||
*/
|
||||
private $object;
|
||||
|
||||
/**
|
||||
* The property path leading to the current value.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
private $propertyPath = '';
|
||||
|
||||
/**
|
||||
* The current validation metadata.
|
||||
*
|
||||
* @var MetadataInterface|null
|
||||
*/
|
||||
private $metadata;
|
||||
|
||||
/**
|
||||
* The currently validated group.
|
||||
*
|
||||
* @var string|null
|
||||
*/
|
||||
private $group;
|
||||
|
||||
/**
|
||||
* The currently validated constraint.
|
||||
*
|
||||
* @var Constraint|null
|
||||
*/
|
||||
private $constraint;
|
||||
|
||||
/**
|
||||
* Stores which objects have been validated in which group.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $validatedObjects = array();
|
||||
|
||||
/**
|
||||
* Stores which class constraint has been validated for which object.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $validatedConstraints = array();
|
||||
|
||||
/**
|
||||
* Stores which objects have been initialized.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $initializedObjects;
|
||||
|
||||
/**
|
||||
* Creates a new execution context.
|
||||
*
|
||||
* @param ValidatorInterface $validator The validator
|
||||
* @param mixed $root The root value of the
|
||||
* validated object graph
|
||||
* @param TranslatorInterface $translator The translator
|
||||
* @param string|null $translationDomain The translation domain to
|
||||
* use for translating
|
||||
* violation messages
|
||||
*
|
||||
* @internal Called by {@link ExecutionContextFactory}. Should not be used
|
||||
* in user code.
|
||||
*/
|
||||
public function __construct(ValidatorInterface $validator, $root, TranslatorInterface $translator, $translationDomain = null)
|
||||
{
|
||||
$this->validator = $validator;
|
||||
$this->root = $root;
|
||||
$this->translator = $translator;
|
||||
$this->translationDomain = $translationDomain;
|
||||
$this->violations = new ConstraintViolationList();
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setNode($value, $object, MetadataInterface $metadata = null, $propertyPath)
|
||||
{
|
||||
$this->value = $value;
|
||||
$this->object = $object;
|
||||
$this->metadata = $metadata;
|
||||
$this->propertyPath = (string) $propertyPath;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setGroup($group)
|
||||
{
|
||||
$this->group = $group;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function setConstraint(Constraint $constraint)
|
||||
{
|
||||
$this->constraint = $constraint;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function addViolation($message, array $parameters = array())
|
||||
{
|
||||
$this->violations->add(new ConstraintViolation(
|
||||
$this->translator->trans($message, $parameters, $this->translationDomain),
|
||||
$message,
|
||||
$parameters,
|
||||
$this->root,
|
||||
$this->propertyPath,
|
||||
$this->value,
|
||||
null,
|
||||
null,
|
||||
$this->constraint
|
||||
));
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function buildViolation($message, array $parameters = array())
|
||||
{
|
||||
return new ConstraintViolationBuilder(
|
||||
$this->violations,
|
||||
$this->constraint,
|
||||
$message,
|
||||
$parameters,
|
||||
$this->root,
|
||||
$this->propertyPath,
|
||||
$this->value,
|
||||
$this->translator,
|
||||
$this->translationDomain
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getViolations()
|
||||
{
|
||||
return $this->violations;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getValidator()
|
||||
{
|
||||
return $this->validator;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getRoot()
|
||||
{
|
||||
return $this->root;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getValue()
|
||||
{
|
||||
return $this->value;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getObject()
|
||||
{
|
||||
return $this->object;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getMetadata()
|
||||
{
|
||||
return $this->metadata;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getGroup()
|
||||
{
|
||||
return $this->group;
|
||||
}
|
||||
|
||||
public function getConstraint()
|
||||
{
|
||||
return $this->constraint;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getClassName()
|
||||
{
|
||||
return $this->metadata instanceof MemberMetadata || $this->metadata instanceof ClassMetadataInterface ? $this->metadata->getClassName() : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getPropertyName()
|
||||
{
|
||||
return $this->metadata instanceof PropertyMetadataInterface ? $this->metadata->getPropertyName() : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function getPropertyPath($subPath = '')
|
||||
{
|
||||
return PropertyPath::append($this->propertyPath, $subPath);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function markGroupAsValidated($cacheKey, $groupHash)
|
||||
{
|
||||
if (!isset($this->validatedObjects[$cacheKey])) {
|
||||
$this->validatedObjects[$cacheKey] = array();
|
||||
}
|
||||
|
||||
$this->validatedObjects[$cacheKey][$groupHash] = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function isGroupValidated($cacheKey, $groupHash)
|
||||
{
|
||||
return isset($this->validatedObjects[$cacheKey][$groupHash]);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function markConstraintAsValidated($cacheKey, $constraintHash)
|
||||
{
|
||||
$this->validatedConstraints[$cacheKey.':'.$constraintHash] = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function isConstraintValidated($cacheKey, $constraintHash)
|
||||
{
|
||||
return isset($this->validatedConstraints[$cacheKey.':'.$constraintHash]);
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function markObjectAsInitialized($cacheKey)
|
||||
{
|
||||
$this->initializedObjects[$cacheKey] = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function isObjectInitialized($cacheKey)
|
||||
{
|
||||
return isset($this->initializedObjects[$cacheKey]);
|
||||
}
|
||||
}
|
||||
55
vendor/symfony/validator/Context/ExecutionContextFactory.php
vendored
Normal file
55
vendor/symfony/validator/Context/ExecutionContextFactory.php
vendored
Normal file
|
|
@ -0,0 +1,55 @@
|
|||
<?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\Component\Validator\Context;
|
||||
|
||||
use Symfony\Component\Translation\TranslatorInterface;
|
||||
use Symfony\Component\Validator\Validator\ValidatorInterface;
|
||||
|
||||
/**
|
||||
* Creates new {@link ExecutionContext} instances.
|
||||
*
|
||||
* @author Bernhard Schussek <bschussek@gmail.com>
|
||||
*
|
||||
* @internal version 2.5. Code against ExecutionContextFactoryInterface instead.
|
||||
*/
|
||||
class ExecutionContextFactory implements ExecutionContextFactoryInterface
|
||||
{
|
||||
private $translator;
|
||||
private $translationDomain;
|
||||
|
||||
/**
|
||||
* Creates a new context factory.
|
||||
*
|
||||
* @param TranslatorInterface $translator The translator
|
||||
* @param string|null $translationDomain The translation domain to
|
||||
* use for translating
|
||||
* violation messages
|
||||
*/
|
||||
public function __construct(TranslatorInterface $translator, $translationDomain = null)
|
||||
{
|
||||
$this->translator = $translator;
|
||||
$this->translationDomain = $translationDomain;
|
||||
}
|
||||
|
||||
/**
|
||||
* {@inheritdoc}
|
||||
*/
|
||||
public function createContext(ValidatorInterface $validator, $root)
|
||||
{
|
||||
return new ExecutionContext(
|
||||
$validator,
|
||||
$root,
|
||||
$this->translator,
|
||||
$this->translationDomain
|
||||
);
|
||||
}
|
||||
}
|
||||
36
vendor/symfony/validator/Context/ExecutionContextFactoryInterface.php
vendored
Normal file
36
vendor/symfony/validator/Context/ExecutionContextFactoryInterface.php
vendored
Normal file
|
|
@ -0,0 +1,36 @@
|
|||
<?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\Component\Validator\Context;
|
||||
|
||||
use Symfony\Component\Validator\Validator\ValidatorInterface;
|
||||
|
||||
/**
|
||||
* Creates instances of {@link ExecutionContextInterface}.
|
||||
*
|
||||
* You can use a custom factory if you want to customize the execution context
|
||||
* that is passed through the validation run.
|
||||
*
|
||||
* @author Bernhard Schussek <bschussek@gmail.com>
|
||||
*/
|
||||
interface ExecutionContextFactoryInterface
|
||||
{
|
||||
/**
|
||||
* Creates a new execution context.
|
||||
*
|
||||
* @param ValidatorInterface $validator The validator
|
||||
* @param mixed $root The root value of the validated
|
||||
* object graph
|
||||
*
|
||||
* @return ExecutionContextInterface The new execution context
|
||||
*/
|
||||
public function createContext(ValidatorInterface $validator, $root);
|
||||
}
|
||||
344
vendor/symfony/validator/Context/ExecutionContextInterface.php
vendored
Normal file
344
vendor/symfony/validator/Context/ExecutionContextInterface.php
vendored
Normal file
|
|
@ -0,0 +1,344 @@
|
|||
<?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\Component\Validator\Context;
|
||||
|
||||
use Symfony\Component\Validator\Constraint;
|
||||
use Symfony\Component\Validator\ConstraintViolationListInterface;
|
||||
use Symfony\Component\Validator\Mapping;
|
||||
use Symfony\Component\Validator\Mapping\MetadataInterface;
|
||||
use Symfony\Component\Validator\Validator\ValidatorInterface;
|
||||
use Symfony\Component\Validator\Violation\ConstraintViolationBuilderInterface;
|
||||
|
||||
/**
|
||||
* The context of a validation run.
|
||||
*
|
||||
* The context collects all violations generated during the validation. By
|
||||
* default, validators execute all validations in a new context:
|
||||
*
|
||||
* $violations = $validator->validate($object);
|
||||
*
|
||||
* When you make another call to the validator, while the validation is in
|
||||
* progress, the violations will be isolated from each other:
|
||||
*
|
||||
* public function validate($value, Constraint $constraint)
|
||||
* {
|
||||
* $validator = $this->context->getValidator();
|
||||
*
|
||||
* // The violations are not added to $this->context
|
||||
* $violations = $validator->validate($value);
|
||||
* }
|
||||
*
|
||||
* However, if you want to add the violations to the current context, use the
|
||||
* {@link ValidatorInterface::inContext()} method:
|
||||
*
|
||||
* public function validate($value, Constraint $constraint)
|
||||
* {
|
||||
* $validator = $this->context->getValidator();
|
||||
*
|
||||
* // The violations are added to $this->context
|
||||
* $validator
|
||||
* ->inContext($this->context)
|
||||
* ->validate($value)
|
||||
* ;
|
||||
* }
|
||||
*
|
||||
* Additionally, the context provides information about the current state of
|
||||
* the validator, such as the currently validated class, the name of the
|
||||
* currently validated property and more. These values change over time, so you
|
||||
* cannot store a context and expect that the methods still return the same
|
||||
* results later on.
|
||||
*
|
||||
* @author Bernhard Schussek <bschussek@gmail.com>
|
||||
*/
|
||||
interface ExecutionContextInterface
|
||||
{
|
||||
/**
|
||||
* Adds a violation at the current node of the validation graph.
|
||||
*
|
||||
* @param string $message The error message
|
||||
* @param array $params The parameters substituted in the error message
|
||||
*/
|
||||
public function addViolation($message, array $params = array());
|
||||
|
||||
/**
|
||||
* Returns a builder for adding a violation with extended information.
|
||||
*
|
||||
* Call {@link ConstraintViolationBuilderInterface::addViolation()} to
|
||||
* add the violation when you're done with the configuration:
|
||||
*
|
||||
* $context->buildViolation('Please enter a number between %min% and %max%.')
|
||||
* ->setParameter('%min%', 3)
|
||||
* ->setParameter('%max%', 10)
|
||||
* ->setTranslationDomain('number_validation')
|
||||
* ->addViolation();
|
||||
*
|
||||
* @param string $message The error message
|
||||
* @param array $parameters The parameters substituted in the error message
|
||||
*
|
||||
* @return ConstraintViolationBuilderInterface The violation builder
|
||||
*/
|
||||
public function buildViolation($message, array $parameters = array());
|
||||
|
||||
/**
|
||||
* Returns the validator.
|
||||
*
|
||||
* Useful if you want to validate additional constraints:
|
||||
*
|
||||
* public function validate($value, Constraint $constraint)
|
||||
* {
|
||||
* $validator = $this->context->getValidator();
|
||||
*
|
||||
* $violations = $validator->validate($value, new Length(array('min' => 3)));
|
||||
*
|
||||
* if (count($violations) > 0) {
|
||||
* // ...
|
||||
* }
|
||||
* }
|
||||
*
|
||||
* @return ValidatorInterface
|
||||
*/
|
||||
public function getValidator();
|
||||
|
||||
/**
|
||||
* Returns the currently validated object.
|
||||
*
|
||||
* If the validator is currently validating a class constraint, the
|
||||
* object of that class is returned. If it is a validating a property or
|
||||
* getter constraint, the object that the property/getter belongs to is
|
||||
* returned.
|
||||
*
|
||||
* In other cases, null is returned.
|
||||
*
|
||||
* @return object|null The currently validated object or null
|
||||
*/
|
||||
public function getObject();
|
||||
|
||||
/**
|
||||
* Sets the currently validated value.
|
||||
*
|
||||
* @param mixed $value The validated value
|
||||
* @param object|null $object The currently validated object
|
||||
* @param MetadataInterface|null $metadata The validation metadata
|
||||
* @param string $propertyPath The property path to the current value
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function setNode($value, $object, MetadataInterface $metadata = null, $propertyPath);
|
||||
|
||||
/**
|
||||
* Sets the currently validated group.
|
||||
*
|
||||
* @param string|null $group The validated group
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function setGroup($group);
|
||||
|
||||
/**
|
||||
* Sets the currently validated constraint.
|
||||
*
|
||||
* @param Constraint $constraint The validated constraint
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function setConstraint(Constraint $constraint);
|
||||
|
||||
/**
|
||||
* Marks an object as validated in a specific validation group.
|
||||
*
|
||||
* @param string $cacheKey The hash of the object
|
||||
* @param string $groupHash The group's name or hash, if it is group
|
||||
* sequence
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function markGroupAsValidated($cacheKey, $groupHash);
|
||||
|
||||
/**
|
||||
* Returns whether an object was validated in a specific validation group.
|
||||
*
|
||||
* @param string $cacheKey The hash of the object
|
||||
* @param string $groupHash The group's name or hash, if it is group
|
||||
* sequence
|
||||
*
|
||||
* @return bool Whether the object was already validated for that
|
||||
* group
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function isGroupValidated($cacheKey, $groupHash);
|
||||
|
||||
/**
|
||||
* Marks a constraint as validated for an object.
|
||||
*
|
||||
* @param string $cacheKey The hash of the object
|
||||
* @param string $constraintHash The hash of the constraint
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function markConstraintAsValidated($cacheKey, $constraintHash);
|
||||
|
||||
/**
|
||||
* Returns whether a constraint was validated for an object.
|
||||
*
|
||||
* @param string $cacheKey The hash of the object
|
||||
* @param string $constraintHash The hash of the constraint
|
||||
*
|
||||
* @return bool Whether the constraint was already validated
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*/
|
||||
public function isConstraintValidated($cacheKey, $constraintHash);
|
||||
|
||||
/**
|
||||
* Marks that an object was initialized.
|
||||
*
|
||||
* @param string $cacheKey The hash of the object
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*
|
||||
* @see ObjectInitializerInterface
|
||||
*/
|
||||
public function markObjectAsInitialized($cacheKey);
|
||||
|
||||
/**
|
||||
* Returns whether an object was initialized.
|
||||
*
|
||||
* @param string $cacheKey The hash of the object
|
||||
*
|
||||
* @return bool Whether the object was already initialized
|
||||
*
|
||||
* @internal Used by the validator engine. Should not be called by user
|
||||
* code.
|
||||
*
|
||||
* @see ObjectInitializerInterface
|
||||
*/
|
||||
public function isObjectInitialized($cacheKey);
|
||||
|
||||
/**
|
||||
* Returns the violations generated by the validator so far.
|
||||
*
|
||||
* @return ConstraintViolationListInterface The constraint violation list
|
||||
*/
|
||||
public function getViolations();
|
||||
|
||||
/**
|
||||
* Returns the value at which validation was started in the object graph.
|
||||
*
|
||||
* The validator, when given an object, traverses the properties and
|
||||
* related objects and their properties. The root of the validation is the
|
||||
* object from which the traversal started.
|
||||
*
|
||||
* The current value is returned by {@link getValue}.
|
||||
*
|
||||
* @return mixed The root value of the validation
|
||||
*/
|
||||
public function getRoot();
|
||||
|
||||
/**
|
||||
* Returns the value that the validator is currently validating.
|
||||
*
|
||||
* If you want to retrieve the object that was originally passed to the
|
||||
* validator, use {@link getRoot}.
|
||||
*
|
||||
* @return mixed The currently validated value
|
||||
*/
|
||||
public function getValue();
|
||||
|
||||
/**
|
||||
* Returns the metadata for the currently validated value.
|
||||
*
|
||||
* With the core implementation, this method returns a
|
||||
* {@link Mapping\ClassMetadataInterface} instance if the current value is an object,
|
||||
* a {@link Mapping\PropertyMetadata} instance if the current value is
|
||||
* the value of a property and a {@link Mapping\GetterMetadata} instance if
|
||||
* the validated value is the result of a getter method.
|
||||
*
|
||||
* If the validated value is neither of these, for example if the validator
|
||||
* has been called with a plain value and constraint, this method returns
|
||||
* null.
|
||||
*
|
||||
* @return MetadataInterface|null the metadata of the currently validated
|
||||
* value
|
||||
*/
|
||||
public function getMetadata();
|
||||
|
||||
/**
|
||||
* Returns the validation group that is currently being validated.
|
||||
*
|
||||
* @return string The current validation group
|
||||
*/
|
||||
public function getGroup();
|
||||
|
||||
/**
|
||||
* Returns the class name of the current node.
|
||||
*
|
||||
* If the metadata of the current node does not implement
|
||||
* {@link Mapping\ClassMetadataInterface} or if no metadata is available for the
|
||||
* current node, this method returns null.
|
||||
*
|
||||
* @return string|null The class name or null, if no class name could be found
|
||||
*/
|
||||
public function getClassName();
|
||||
|
||||
/**
|
||||
* Returns the property name of the current node.
|
||||
*
|
||||
* If the metadata of the current node does not implement
|
||||
* {@link PropertyMetadataInterface} or if no metadata is available for the
|
||||
* current node, this method returns null.
|
||||
*
|
||||
* @return string|null The property name or null, if no property name could be found
|
||||
*/
|
||||
public function getPropertyName();
|
||||
|
||||
/**
|
||||
* Returns the property path to the value that the validator is currently
|
||||
* validating.
|
||||
*
|
||||
* For example, take the following object graph:
|
||||
*
|
||||
* <pre>
|
||||
* (Person)---($address: Address)---($street: string)
|
||||
* </pre>
|
||||
*
|
||||
* When the <tt>Person</tt> instance is passed to the validator, the
|
||||
* property path is initially empty. When the <tt>$address</tt> property
|
||||
* of that person is validated, the property path is "address". When
|
||||
* the <tt>$street</tt> property of the related <tt>Address</tt> instance
|
||||
* is validated, the property path is "address.street".
|
||||
*
|
||||
* Properties of objects are prefixed with a dot in the property path.
|
||||
* Indices of arrays or objects implementing the {@link \ArrayAccess}
|
||||
* interface are enclosed in brackets. For example, if the property in
|
||||
* the previous example is <tt>$addresses</tt> and contains an array
|
||||
* of <tt>Address</tt> instance, the property path generated for the
|
||||
* <tt>$street</tt> property of one of these addresses is for example
|
||||
* "addresses[0].street".
|
||||
*
|
||||
* @param string $subPath Optional. The suffix appended to the current
|
||||
* property path.
|
||||
*
|
||||
* @return string The current property path. The result may be an empty
|
||||
* string if the validator is currently validating the
|
||||
* root value of the validation graph.
|
||||
*/
|
||||
public function getPropertyPath($subPath = '');
|
||||
}
|
||||
Reference in a new issue