vendor/symfony/validator/Constraints/Length.php line 25

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <[email protected]>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Validator\Constraints;
  14. use Symfony\Component\Validator\Constraint;
  15. use Symfony\Component\Validator\Exception\InvalidArgumentException;
  16. use Symfony\Component\Validator\Exception\MissingOptionsException;
  18. /**
  19.  * @Annotation
  20.  * @Target({"PROPERTY", "METHOD", "ANNOTATION"})
  21.  *
  22.  * @author Bernhard Schussek <[email protected]>
  23.  */
  24. #[\Attribute(\Attribute::TARGET_PROPERTY | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
  25. class Length extends Constraint
  26. {
  27.     public const TOO_SHORT_ERROR = '9ff3fdc4-b214-49db-8718-39c315e33d45';
  28.     public const TOO_LONG_ERROR = 'd94b19cc-114f-4f44-9cc4-4138e80a87b9';
  29.     public const NOT_EQUAL_LENGTH_ERROR = '4b6f5c76-22b4-409d-af16-fbe823ba9332';
  30.     public const INVALID_CHARACTERS_ERROR = '35e6a710-aa2e-4719-b58e-24b35749b767';
  32.     protected static $errorNames = [
  33.         self::TOO_SHORT_ERROR => 'TOO_SHORT_ERROR',
  34.         self::TOO_LONG_ERROR => 'TOO_LONG_ERROR',
  35.         self::NOT_EQUAL_LENGTH_ERROR => 'NOT_EQUAL_LENGTH_ERROR',
  36.         self::INVALID_CHARACTERS_ERROR => 'INVALID_CHARACTERS_ERROR',
  37.     ];
  39.     public $maxMessage = 'This value is too long. It should have {{ limit }} character or less.|This value is too long. It should have {{ limit }} characters or less.';
  40.     public $minMessage = 'This value is too short. It should have {{ limit }} character or more.|This value is too short. It should have {{ limit }} characters or more.';
  41.     public $exactMessage = 'This value should have exactly {{ limit }} character.|This value should have exactly {{ limit }} characters.';
  42.     public $charsetMessage = 'This value does not match the expected {{ charset }} charset.';
  43.     public $max;
  44.     public $min;
  45.     public $charset = 'UTF-8';
  46.     public $normalizer;
  47.     public $allowEmptyString = false;
  49.     /**
  50.      * {@inheritdoc}
  51.      *
  52.      * @param int|array|null $exactly The expected exact length or a set of options
  53.      */
  54.     public function __construct(
  55.         $exactly = null,
  56.         ?int $min = null,
  57.         ?int $max = null,
  58.         ?string $charset = null,
  59.         ?callable $normalizer = null,
  60.         ?string $exactMessage = null,
  61.         ?string $minMessage = null,
  62.         ?string $maxMessage = null,
  63.         ?string $charsetMessage = null,
  64.         ?array $groups = null,
  65.         $payload = null,
  66.         array $options = []
  67.     ) {
  68.         if (\is_array($exactly)) {
  69.             $options = array_merge($exactly, $options);
  70.             $exactly = $options['value'] ?? null;
  71.         }
  73.         $min = $min ?? $options['min'] ?? null;
  74.         $max = $max ?? $options['max'] ?? null;
  76.         unset($options['value'], $options['min'], $options['max']);
  78.         if (null !== $exactly && null === $min && null === $max) {
  79.             $min = $max = $exactly;
  80.         }
  82.         parent::__construct($options, $groups, $payload);
  84.         $this->min = $min;
  85.         $this->max = $max;
  86.         $this->charset = $charset ?? $this->charset;
  87.         $this->normalizer = $normalizer ?? $this->normalizer;
  88.         $this->exactMessage = $exactMessage ?? $this->exactMessage;
  89.         $this->minMessage = $minMessage ?? $this->minMessage;
  90.         $this->maxMessage = $maxMessage ?? $this->maxMessage;
  91.         $this->charsetMessage = $charsetMessage ?? $this->charsetMessage;
  93.         if (null === $this->min && null === $this->max) {
  94.             throw new MissingOptionsException(sprintf('Either option "min" or "max" must be given for constraint "%s".', __CLASS__), ['min', 'max']);
  95.         }
  97.         if (null !== $this->normalizer && !\is_callable($this->normalizer)) {
  98.             throw new InvalidArgumentException(sprintf('The "normalizer" option must be a valid callable ("%s" given).', get_debug_type($this->normalizer)));
  99.         }
  101.         if (isset($options['allowEmptyString'])) {
  102.             trigger_deprecation('symfony/validator', '5.2', sprintf('The "allowEmptyString" option of the "%s" constraint is deprecated.', self::class));
  103.         }
  104.     }
  105. }