Range

Version: 2.1
Edit this page

Warning: You are browsing the documentation for Symfony 2.1, which is no longer maintained.

Read the updated version of this page for Symfony 6.0 (the current stable version).

Range

Validates that a given number is between some minimum and maximum number.

New in version 2.1

The Range constraint was added in Symfony 2.1.

Applies to property or method
Options
Class Range
Validator RangeValidator

Basic Usage

To verify that the "height" field of a class is between "120" and "180", you might add the following:

  • YAML
  • Annotations
  • XML
  • PHP
1
2
3
4
5
6
7
8
9
# src/Acme/EventBundle/Resources/config/validation.yml
Acme\EventBundle\Entity\Participant:
    properties:
        height:
            - Range:
                min: 120
                max: 180
                minMessage: You must be at least 120cm tall to enter
                maxMessage: You cannot be taller than 180cm to enter

Options

min

type: integer [default option]

This required option is the "min" value. Validation will fail if the given value is less than this min value.

max

type: integer [default option]

This required option is the "max" value. Validation will fail if the given value is greater than this max value.

minMessage

type: string default: This value should be {{ limit }} or more.

The message that will be shown if the underlying value is less than the min option.

maxMessage

type: string default: This value should be {{ limit }} or less.

The message that will be shown if the underlying value is more than the max option.

invalidMessage

type: string default: This value should be a valid number.

The message that will be shown if the underlying value is not a number (per the is_numeric PHP function).

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.