?HAMA

Navigation

Breadcrumbs

/ / opt / cloudlinux / alt-php53 / root / usr / share / pear / Symfony / Component / Validator

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 6.64 KB

/opt/cloudlinux/alt-php53/root/usr/share/pear/Symfony/Component/Validator/Constraint.php

Text Base64

<?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;

use Symfony\Component\Validator\Exception\InvalidOptionsException;
use Symfony\Component\Validator\Exception\MissingOptionsException;
use Symfony\Component\Validator\Exception\ConstraintDefinitionException;

/**
 * Contains the properties of a constraint definition.
 *
 * A constraint can be defined on a class, an option or a getter method.
 * The Constraint class encapsulates all the configuration required for
 * validating this class, option or getter result successfully.
 *
 * Constraint instances are immutable and serializable.
 *
 * @author Bernhard Schussek <bschussek@gmail.com>
 *
 * @api
 */
abstract class Constraint
{
    /**
     * The name of the group given to all constraints with no explicit group
     * @var string
     */
    const DEFAULT_GROUP = 'Default';

/**
     * Marks a constraint that can be put onto classes
     * @var string
     */
    const CLASS_CONSTRAINT = 'class';

/**
     * Marks a constraint that can be put onto properties
     * @var string
     */
    const PROPERTY_CONSTRAINT = 'property';

/**
     * @var array
     */
    public $groups = array(self::DEFAULT_GROUP);

/**
     * Initializes the constraint with options.
     *
     * You should pass an associative array. The keys should be the names of
     * existing properties in this class. The values should be the value for these
     * properties.
     *
     * Alternatively you can override the method getDefaultOption() to return the
     * name of an existing property. If no associative array is passed, this
     * property is set instead.
     *
     * You can force that certain options are set by overriding
     * getRequiredOptions() to return the names of these options. If any
     * option is not set here, an exception is thrown.
     *
     * @param mixed $options The options (as associative array)
     *                       or the value for the default
     *                       option (any other type)
     *
     * @throws InvalidOptionsException       When you pass the names of non-existing
     *                                       options
     * @throws MissingOptionsException       When you don't pass any of the options
     *                                       returned by getRequiredOptions()
     * @throws ConstraintDefinitionException When you don't pass an associative
     *                                       array, but getDefaultOption() returns
     *                                       null
     *
     * @api
     */
    public function __construct($options = null)
    {
        $invalidOptions = array();
        $missingOptions = array_flip((array) $this->getRequiredOptions());

if (is_array($options) && count($options) >= 1 && isset($options['value']) && !property_exists($this, 'value')) {
            $options[$this->getDefaultOption()] = $options['value'];
            unset($options['value']);
        }

if (is_array($options) && count($options) > 0 && is_string(key($options))) {
            foreach ($options as $option => $value) {
                if (property_exists($this, $option)) {
                    $this->$option = $value;
                    unset($missingOptions[$option]);
                } else {
                    $invalidOptions[] = $option;
                }
            }
        } elseif (null !== $options && ! (is_array($options) && count($options) === 0)) {
            $option = $this->getDefaultOption();

if (null === $option) {
                throw new ConstraintDefinitionException(
                    sprintf('No default option is configured for constraint %s', get_class($this))
                );
            }

if (property_exists($this, $option)) {
                $this->$option = $options;
                unset($missingOptions[$option]);
            } else {
                $invalidOptions[] = $option;
            }
        }

if (count($invalidOptions) > 0) {
            throw new InvalidOptionsException(
                sprintf('The options "%s" do not exist in constraint %s', implode('", "', $invalidOptions), get_class($this)),
                $invalidOptions
            );
        }

if (count($missingOptions) > 0) {
            throw new MissingOptionsException(
                sprintf('The options "%s" must be set for constraint %s', implode('", "', array_keys($missingOptions)), get_class($this)),
                array_keys($missingOptions)
            );
        }

$this->groups = (array) $this->groups;
    }

/**
     * Unsupported operation.
     */
    public function __set($option, $value)
    {
        throw new InvalidOptionsException(sprintf('The option "%s" does not exist in constraint %s', $option, get_class($this)), array($option));
    }

/**
     * Adds the given group if this constraint is in the Default group
     *
     * @param string $group
     *
     * @api
     */
    public function addImplicitGroupName($group)
    {
        if (in_array(Constraint::DEFAULT_GROUP, $this->groups) && !in_array($group, $this->groups)) {
            $this->groups[] = $group;
        }
    }

/**
     * Returns the name of the default option
     *
     * Override this method to define a default option.
     *
     * @return string
     * @see __construct()
     *
     * @api
     */
    public function getDefaultOption()
    {
        return null;
    }

/**
     * Returns the name of the required options
     *
     * Override this method if you want to define required options.
     *
     * @return array
     * @see __construct()
     *
     * @api
     */
    public function getRequiredOptions()
    {
        return array();
    }

/**
     * Returns the name of the class that validates this constraint
     *
     * By default, this is the fully qualified name of the constraint class
     * suffixed with "Validator". You can override this method to change that
     * behaviour.
     *
     * @return string
     *
     * @api
     */
    public function validatedBy()
    {
        return get_class($this).'Validator';
    }

/**
     * Returns whether the constraint can be put onto classes, properties or
     * both
     *
     * This method should return one or more of the constants
     * Constraint::CLASS_CONSTRAINT and Constraint::PROPERTY_CONSTRAINT.
     *
     * @return string|array  One or more constant values
     *
     * @api
     */
    public function getTargets()
    {
        return self::PROPERTY_CONSTRAINT;
    }
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 4 × Files: 28

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
Constraints DIR	-	drwxr-xr-x	2024-03-03 22:55:08	Edit Download recursive recursive
Exception DIR	-	drwxr-xr-x	2024-03-03 22:55:08	Edit Download recursive recursive
Mapping DIR	-	drwxr-xr-x	2024-03-03 22:55:08	Edit Download recursive recursive
Resources DIR	-	drwxr-xr-x	2024-03-03 22:55:08	Edit Download recursive recursive
autoloader.php	339 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ClassBasedInterface.php	572 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
Constraint.php	6.64 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintValidator.php	700 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintValidatorFactory.php	2.24 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintValidatorFactoryInterface.php	775 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintValidatorInterface.php	899 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintViolation.php	4.23 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintViolationInterface.php	4.25 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintViolationList.php	3.17 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ConstraintViolationListInterface.php	1.96 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
DefaultTranslator.php	5.12 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ExecutionContext.php	8.30 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ExecutionContextInterface.php	12.07 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
GlobalExecutionContextInterface.php	1.89 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
GroupSequenceProviderInterface.php	597 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
MetadataFactoryInterface.php	990 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
MetadataInterface.php	2.82 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ObjectInitializerInterface.php	817 B	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
PropertyMetadataContainerInterface.php	1.18 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
PropertyMetadataInterface.php	1.23 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
Validation.php	1.07 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ValidationVisitor.php	6.17 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ValidationVisitorInterface.php	3.46 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
Validator.php	6.52 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ValidatorBuilder.php	9.85 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ValidatorBuilderInterface.php	5.37 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive
ValidatorInterface.php	3.50 KB	lrw-r--r--	2019-12-18 11:20:44	Edit Download recursive recursive