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 <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 INVALID_CHARACTERS_ERROR = '35e6a710-aa2e-4719-b58e-24b35749b767';
  31.     protected static $errorNames = [
  32.         self::TOO_SHORT_ERROR => 'TOO_SHORT_ERROR',
  33.         self::TOO_LONG_ERROR => 'TOO_LONG_ERROR',
  34.         self::INVALID_CHARACTERS_ERROR => 'INVALID_CHARACTERS_ERROR',
  35.     ];
  37.     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.';
  38.     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.';
  39.     public $exactMessage = 'This value should have exactly {{ limit }} character.|This value should have exactly {{ limit }} characters.';
  40.     public $charsetMessage = 'This value does not match the expected {{ charset }} charset.';
  41.     public $max;
  42.     public $min;
  43.     public $charset = 'UTF-8';
  44.     public $normalizer;
  45.     public $allowEmptyString = false;
  47.     /**
  48.      * {@inheritdoc}
  49.      *
  50.      * @param int|array|null $exactly The expected exact length or a set of options
  51.      */
  52.     public function __construct(
  53.         $exactly = null,
  54.         int $min = null,
  55.         int $max = null,
  56.         string $charset = null,
  57.         callable $normalizer = null,
  58.         string $exactMessage = null,
  59.         string $minMessage = null,
  60.         string $maxMessage = null,
  61.         string $charsetMessage = null,
  62.         array $groups = null,
  63.         $payload = null,
  64.         array $options = []
  65.     ) {
  66.         if (\is_array($exactly)) {
  67.             $options = array_merge($exactly, $options);
  68.             $exactly = $options['value'] ?? null;
  69.         }
  71.         $min = $min ?? $options['min'] ?? null;
  72.         $max = $max ?? $options['max'] ?? null;
  74.         unset($options['value'], $options['min'], $options['max']);
  76.         if (null !== $exactly && null === $min && null === $max) {
  77.             $min = $max = $exactly;
  78.         }
  80.         parent::__construct($options, $groups, $payload);
  82.         $this->min = $min;
  83.         $this->max = $max;
  84.         $this->charset = $charset ?? $this->charset;
  85.         $this->normalizer = $normalizer ?? $this->normalizer;
  86.         $this->exactMessage = $exactMessage ?? $this->exactMessage;
  87.         $this->minMessage = $minMessage ?? $this->minMessage;
  88.         $this->maxMessage = $maxMessage ?? $this->maxMessage;
  89.         $this->charsetMessage = $charsetMessage ?? $this->charsetMessage;
  91.         if (null === $this->min && null === $this->max) {
  92.             throw new MissingOptionsException(sprintf('Either option "min" or "max" must be given for constraint "%s".', __CLASS__), ['min', 'max']);
  93.         }
  95.         if (null !== $this->normalizer && !\is_callable($this->normalizer)) {
  96.             throw new InvalidArgumentException(sprintf('The "normalizer" option must be a valid callable ("%s" given).', get_debug_type($this->normalizer)));
  97.         }
  99.         if (isset($options['allowEmptyString'])) {
  100.             trigger_deprecation('symfony/validator', '5.2', sprintf('The "allowEmptyString" option of the "%s" constraint is deprecated.', self::class));
  101.         }
  102.     }
  103. }