gnu-social/vendor/symfony/validator/ValidatorInterface.php

104 lines
4.1 KiB
PHP
Raw Normal View History

2020-08-07 23:42:38 +01:00
<?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;
/**
* Validates values and graphs of objects and arrays.
*
* @author Bernhard Schussek <bschussek@gmail.com>
*
* @deprecated since version 2.5, to be removed in 3.0.
* Use {@link \Symfony\Component\Validator\Validator\ValidatorInterface} instead.
*/
interface ValidatorInterface
{
/**
* Validates a value.
*
* The accepted values depend on the {@link MetadataFactoryInterface}
* implementation.
*
* The signature changed with Symfony 2.5 (see
* {@link Validator\ValidatorInterface::validate()}. This signature will be
* disabled in Symfony 3.0.
*
* @param mixed $value The value to validate
* @param array|null $groups The validation groups to validate
* @param bool $traverse Whether to traverse the value if it is traversable
* @param bool $deep Whether to traverse nested traversable values recursively
*
* @return ConstraintViolationListInterface A list of constraint violations. If the
* list is empty, validation succeeded.
*/
public function validate($value, $groups = null, $traverse = false, $deep = false);
/**
* Validates a property of a value against its current value.
*
* The accepted values depend on the {@link MetadataFactoryInterface}
* implementation.
*
* @param mixed $containingValue The value containing the property
* @param string $property The name of the property to validate
* @param array|null $groups The validation groups to validate
*
* @return ConstraintViolationListInterface A list of constraint violations. If the
* list is empty, validation succeeded.
*/
public function validateProperty($containingValue, $property, $groups = null);
/**
* Validate a property of a value against a potential value.
*
* The accepted values depend on the {@link MetadataFactoryInterface}
* implementation.
*
* @param mixed $containingValue The value containing the property
* @param string $property The name of the property to validate
* @param string $value The value to validate against the
* constraints of the property
* @param array|null $groups The validation groups to validate
*
* @return ConstraintViolationListInterface A list of constraint violations. If the
* list is empty, validation succeeded.
*/
public function validatePropertyValue($containingValue, $property, $value, $groups = null);
/**
* Validates a value against a constraint or a list of constraints.
*
* @param mixed $value The value to validate
* @param Constraint|Constraint[] $constraints The constraint(s) to validate against
* @param array|null $groups The validation groups to validate
*
* @return ConstraintViolationListInterface A list of constraint violations. If the
* list is empty, validation succeeded.
*
* @deprecated since version 2.5, to be removed in 3.0.
* Renamed to {@link Validator\ValidatorInterface::validate()}
* in Symfony 2.5.
*/
public function validateValue($value, $constraints, $groups = null);
/**
* Returns the factory for metadata instances.
*
* @return MetadataFactoryInterface The metadata factory
*
* @deprecated since version 2.5, to be removed in 3.0.
* Use {@link Validator\ValidatorInterface::getMetadataFor()} or
* {@link Validator\ValidatorInterface::hasMetadataFor()}
* instead.
*/
public function getMetadataFactory();
}