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 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. }