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

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  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 <bschussek@gmail.com>
  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 const ERROR_NAMES = [
  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.     /**
  40.      * @deprecated since Symfony 6.1, use const ERROR_NAMES instead
  41.      */
  42.     protected static $errorNames = self::ERROR_NAMES;
  44.     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.';
  45.     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.';
  46.     public $exactMessage = 'This value should have exactly {{ limit }} character.|This value should have exactly {{ limit }} characters.';
  47.     public $charsetMessage = 'This value does not match the expected {{ charset }} charset.';
  48.     public $max;
  49.     public $min;
  50.     public $charset = 'UTF-8';
  51.     public $normalizer;
  53.     public function __construct(
  54.         int|array $exactly = null,
  55.         int $min = null,
  56.         int $max = null,
  57.         string $charset = null,
  58.         callable $normalizer = null,
  59.         string $exactMessage = null,
  60.         string $minMessage = null,
  61.         string $maxMessage = null,
  62.         string $charsetMessage = null,
  63.         array $groups = null,
  64.         mixed $payload = null,
  65.         array $options = []
  66.     ) {
  67.         if (\is_array($exactly)) {
  68.             $options = array_merge($exactly, $options);
  69.             $exactly = $options['value'] ?? null;
  70.         }
  72.         $min ??= $options['min'] ?? null;
  73.         $max ??= $options['max'] ?? null;
  75.         unset($options['value'], $options['min'], $options['max']);
  77.         if (null !== $exactly && null === $min && null === $max) {
  78.             $min = $max = $exactly;
  79.         }
  81.         parent::__construct($options, $groups, $payload);
  83.         $this->min = $min;
  84.         $this->max = $max;
  85.         $this->charset = $charset ?? $this->charset;
  86.         $this->normalizer = $normalizer ?? $this->normalizer;
  87.         $this->exactMessage = $exactMessage ?? $this->exactMessage;
  88.         $this->minMessage = $minMessage ?? $this->minMessage;
  89.         $this->maxMessage = $maxMessage ?? $this->maxMessage;
  90.         $this->charsetMessage = $charsetMessage ?? $this->charsetMessage;
  92.         if (null === $this->min && null === $this->max) {
  93.             throw new MissingOptionsException(sprintf('Either option "min" or "max" must be given for constraint "%s".', __CLASS__), ['min', 'max']);
  94.         }
  96.         if (null !== $this->normalizer && !\is_callable($this->normalizer)) {
  97.             throw new InvalidArgumentException(sprintf('The "normalizer" option must be a valid callable ("%s" given).', get_debug_type($this->normalizer)));
  98.         }
  99.     }
  100. }