Mar 13, 2015 · Dec 31, 2014 · Mar 10, 2015 · Mar 8, 2015 · Mar 10, 2015 · Mar 8, 2015
diff --git a/cookbook/map.rst.inc b/cookbook/map.rst.inc
 * :doc:`/cookbook/validation/index`

  * :doc:`/cookbook/validation/custom_constraint`
  * :doc:`/cookbook/validation/severity`

 * :doc:`/cookbook/web_server/index`

diff --git a/cookbook/validation/index.rst b/cookbook/validation/index.rst
    :maxdepth: 2

    custom_constraint
    severity
diff --git a/cookbook/validation/severity.rst b/cookbook/validation/severity.rst
 .. index::
    single: Validation; Error Levels
    single: Validation; Payload

 How to Handle Different Error Levels
 ====================================

 Sometimes, you may want to display constraint validation error messages differently
 based on some rules. For example, you have a registration form for new users
 where they enter some personal information and choose their authentication
 credentials. They would have to choose a username and a secure password,
 but providing bank account information would be optional. Nonetheless, you
 want to make sure that these optional data, if entered, are still valid,
 but display them differently.

 The process to achieve this behavior consists of two steps:

 #. Apply different error levels to the validation constraints;
 #. Customize your error messages depending on the configured error level.

 1. Assigning the Error Level
 ----------------------------

 .. versionadded:: 2.6
    The ``payload`` option was introduced in Symfony 2.6.

 Use the ``payload`` option to configure the error level for each constraint:

 .. configuration-block::

    .. code-block:: php-annotations

        // src/AppBundle/Entity/User.php
        namespace AppBundle\Entity;

        use Symfony\Component\Validator\Constraints as Assert;

        class User
        {
            /**
             * @Assert\NotBlank(payload = {severity = "error"})
             */
            protected $username;

            /**
             * @Assert\NotBlank(payload = {severity = "error"})
             */
            protected $password;

            /**
             * @Assert\Iban(payload = {severity = "warning"})
             */
            protected $bankAccountNumber;
        }

    .. code-block:: yaml

        # src/AppBundle/Resources/config/validation.yml
        AppBundle\Entity\User:
            properties:
                username:
                    - NotBlank:
                        payload:
                            severity: error
                password:
                    - NotBlank:
                        payload:
                            severity: error
                bankAccountNumber:
                    - Iban:
                        payload:
                            severity: warning

    .. code-block:: xml

        <!-- src/AppBundle/Resources/config/validation.xml -->
        <?xml version="1.0" encoding="UTF-8" ?>
        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

            <class name="AppBundle\Entity\User">
                <property name="username">
                    <constraint name="NotBlank">
                        <option name="payload">
                            <value key="severity">error</value>
                        </option>
                    </constraint>
                </property>
                <property name="password">
                    <constraint name="NotBlank">
                        <option name="payload">
                            <value key="severity">error</value>
                        </option>
                    </constraint>
                </property>
                <property name="bankAccountNumber">
                    <constraint name="Iban">
                        <option name="payload">
                            <value key="severity">warning</value>
                        </option>
                    </constraint>
                </property>
            </class>
        </constraint-mapping>

    .. code-block:: php

        // src/AppBundle/Entity/User.php
        namespace AppBundle\Entity;

        use Symfony\Component\Validator\Mapping\ClassMetadata;
        use Symfony\Component\Validator\Constraints as Assert;

        class User
        {
            public static function loadValidatorMetadata(ClassMetadata $metadata)
            {
                $metadata->addPropertyConstraint('username', new Assert\NotBlank(array(
                    'payload' => array('severity' => 'error'),
                )));
                $metadata->addPropertyConstraint('password', new Assert\NotBlank(array(
                    'payload' => array('severity' => 'error'),
                )));
                $metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban(array(
                    'payload' => array('severity' => 'warning'),
                )));
            }
        }

 2. Customize the Error Message Template
 ---------------------------------------

 .. versionadded:: 2.6
    The ``getConstraint()`` method in the ``ConstraintViolation`` class was
    introduced in Symfony 2.6.

 When validating the ``User`` object failed, you can retrieve the constraint
 that caused a particular failure using the
 :method:`Symfony\\Component\\Validator\\ConstraintViolation::getConstraint`
 method. Each constraint exposes the attached payload as a public property::

    // a constraint validation failure, instance of
    // Symfony\Component\Validator\ConstraintViolation
    $constraintViolation = ...;
    $constraint = $constraintViolation->getConstraint();
    $severity = isset($constraint->payload['severity']) ? $constraint->payload['severity'] : null;

 For example, you can leverage this to customize the ``form_errors`` block
 such that the severity is added as an additional HTML class:

 .. code-block:: html+jinja

    {%- block form_errors -%}
        {%- if errors|length > 0 -%}
        <ul>
            {%- for error in errors -%}
                {% if error.cause.constraint.payload.severity is defined %}
                    {% set severity = error.cause.constraint.payload.severity %}
                {% endif %}
                <li{% if severity is defined %} class="{{ severity }}"{% endif %}>{{ error.message }}</li>
            {%- endfor -%}
        </ul>
        {%- endif -%}
    {%- endblock form_errors -%}
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
 | Applies to     | :ref:`property or method <validation-property-target>`                 |
 +----------------+------------------------------------------------------------------------+
 | Options        | - `constraints`_                                                       |
 |                | - `payload`_                                                           |
 +----------------+------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\All`               |
 +----------------+------------------------------------------------------------------------+

 This required option is the array of validation constraints that you want
 to apply to each element of the underlying array.

 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
 | Applies to     | :ref:`property or method <validation-property-target>`                |
 +----------------+-----------------------------------------------------------------------+
 | Options        | - `message`_                                                          |
 |                | - `payload`_                                                          |
 +----------------+-----------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Blank`            |
 +----------------+-----------------------------------------------------------------------+
 **type**: ``string`` **default**: ``This value should be blank.``

 This is the message that will be shown if the value is not blank.

 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
 | Applies to     | :ref:`class <validation-class-target>`                                 |
 +----------------+------------------------------------------------------------------------+
 | Options        | - :ref:`callback <callback-option>`                                    |
 |                | - `payload`_                                                           |
 +----------------+------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Callback`          |
 +----------------+------------------------------------------------------------------------+
 Static or closure callbacks receive the validated object as the first argument
 and the :class:`Symfony\\Component\\Validator\\ExecutionContextInterface`
 instance as the second argument.

 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
 +----------------+--------------------------------------------------------------------------+
 | Options        | - `schemes`_                                                             |
 |                | - `message`_                                                             |
 |                | - `payload`_                                                             |
 +----------------+--------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\CardScheme`          |
 +----------------+--------------------------------------------------------------------------+

 The message shown when the value does not pass the ``CardScheme`` check.

 .. include:: /reference/constraints/_payload-option.rst.inc

 .. _`Wikipedia: Issuer identification number (IIN)`: http://en.wikipedia.org/wiki/Bank_card_number#Issuer_identification_number_.28IIN.29
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
 |                | - `minMessage`_                                                       |
 |                | - `maxMessage`_                                                       |
 |                | - `strict`_                                                           |
 |                | - `payload`_                                                          |
 +----------------+-----------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Choice`           |
 +----------------+-----------------------------------------------------------------------+

        use Symfony\Component\Validator\Mapping\ClassMetadata;
        use Symfony\Component\Validator\Constraints as Assert;


        class Author
        {
            protected $gender;


            public static function loadValidatorMetadata(ClassMetadata $metadata)
            {
                $metadata->addPropertyConstraint('gender', new Assert\Choice(array(

        use Symfony\Component\Validator\Mapping\ClassMetadata;
        use Symfony\Component\Validator\Constraints as Assert;


        class Author
        {
            protected $gender;


            public static function loadValidatorMetadata(ClassMetadata $metadata)
            {
                $metadata->addPropertyConstraint('gender', new Assert\Choice(array(

        use Symfony\Component\Validator\Mapping\ClassMetadata;
        use Symfony\Component\Validator\Constraints as Assert;


        class Author
        {
            protected $gender;


            public static function loadValidatorMetadata(ClassMetadata $metadata)
            {
                $metadata->addPropertyConstraint('gender', new Assert\Choice(array(
 If true, the validator will also check the type of the input value. Specifically,
 this value is passed to as the third argument to the PHP :phpfunction:`in_array` method
 when checking to see if a value is in the valid choices array.

 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
 |                | - `extraFieldsMessage`_                                                  |
 |                | - `allowMissingFields`_                                                  |
 |                | - `missingFieldsMessage`_                                                |
 |                | - `payload`_                                                             |
 +----------------+--------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Collection`          |
 +----------------+--------------------------------------------------------------------------+

 The message shown if `allowMissingFields`_ is false and one or more fields
 are missing from the underlying collection.

 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
 || - `minMessage`_|
 || - `maxMessage`_|
 || - `exactMessage`_|
 || - `payload`_|
 +----------------+---------------------------------------------------------------------+
 | Class|:class:`Symfony\\Component\\Validator\\Constraints\\Count`|
 +----------------+---------------------------------------------------------------------+

 The message that will be shown if min and max values are equal and the underlying collection elements
 count is not exactly this value.

 ..include::/reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
 | Applies to     | :ref:`property or method <validation-property-target>`                 |
 +----------------+------------------------------------------------------------------------+
 | Options        | - `message`_                                                           |
 |                | - `payload`_                                                           |
 +----------------+------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Country`           |
 +----------------+------------------------------------------------------------------------+

 This message is shown if the string is not a valid country code.

 .. include:: /reference/constraints/_payload-option.rst.inc

 .. _`ISO 3166-1 alpha-2`: http://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
 | Applies to     | :ref:`property or method<validation-property-target>`                     |
 +----------------+---------------------------------------------------------------------------+
 | Options        | - `message`_                                                              |
 |                | - `payload`_                                                              |
 +----------------+---------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Currency`             |
 +----------------+---------------------------------------------------------------------------+

 This is the message that will be shown if the value is not a valid currency.

 .. include:: /reference/constraints/_payload-option.rst.inc

 .. _`3-letter ISO 4217`: http://en.wikipedia.org/wiki/ISO_4217
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
 | Applies to     | :ref:`property or method <validation-property-target>`             |
 +----------------+--------------------------------------------------------------------+
 | Options        | - `message`_                                                       |
 |                | - `payload`_                                                       |
 +----------------+--------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Date`          |
 +----------------+--------------------------------------------------------------------+
 **type**: ``string`` **default**: ``This value is not a valid date.``

 This message is shown if the underlying data is not a valid date.

 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
 | Applies to     | :ref:`property or method <validation-property-target>`                 |
 +----------------+------------------------------------------------------------------------+
 | Options        | - `message`_                                                           |
 |                | - `payload`_                                                           |
 +----------------+------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\DateTime`          |
 +----------------+------------------------------------------------------------------------+
 **type**: ``string`` **default**: ``This value is not a valid datetime.``

 This message is shown if the underlying data is not a valid datetime.

 .. include:: /reference/constraints/_payload-option.rst.inc
Original file line number	Diff line number	Diff line change
Expand Up		@@ -214,6 +214,7 @@
		* :doc:`/cookbook/validation/index`

		* :doc:`/cookbook/validation/custom_constraint`
		* :doc:`/cookbook/validation/severity`

		* :doc:`/cookbook/web_server/index`

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -5,3 +5,4 @@ Validation
		:maxdepth: 2

		custom_constraint
		severity
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,165 @@
		.. index::
		single: Validation; Error Levels
		single: Validation; Payload

		How to Handle Different Error Levels
		====================================

		Sometimes, you may want to display constraint validation error messages differently
		based on some rules. For example, you have a registration form for new users
		where they enter some personal information and choose their authentication
		credentials. They would have to choose a username and a secure password,
		but providing bank account information would be optional. Nonetheless, you
		want to make sure that these optional data, if entered, are still valid,
		but display them differently.

		The process to achieve this behavior consists of two steps:

		#. Apply different error levels to the validation constraints;
		#. Customize your error messages depending on the configured error level.

		1. Assigning the Error Level
		----------------------------

		.. versionadded:: 2.6
		The ``payload`` option was introduced in Symfony 2.6.

		Use the ``payload`` option to configure the error level for each constraint:

		.. configuration-block::

		.. code-block:: php-annotations
Copy link Member wouterjMar 8, 2015 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. annotations should now be the first Copy link MemberAuthor xabbuhMar 10, 2015 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. done

		// src/AppBundle/Entity/User.php
		namespace AppBundle\Entity;

		use Symfony\Component\Validator\Constraints as Assert;

		class User
		{
		/**
		* @Assert\NotBlank(payload = {severity = "error"})
		*/
		protected $username;

		/**
		* @Assert\NotBlank(payload = {severity = "error"})
		*/
		protected $password;

		/**
		* @Assert\Iban(payload = {severity = "warning"})
		*/
		protected $bankAccountNumber;
		}

		.. code-block:: yaml

		# src/AppBundle/Resources/config/validation.yml
		AppBundle\Entity\User:
		properties:
		username:
		- NotBlank:
		payload:
		severity: error
		password:
		- NotBlank:
		payload:
		severity: error
		bankAccountNumber:
		- Iban:
		payload:
		severity: warning

		.. code-block:: xml

		<!-- src/AppBundle/Resources/config/validation.xml -->
		<?xml version="1.0" encoding="UTF-8" ?>
		<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">

		<class name="AppBundle\Entity\User">
		<property name="username">
		<constraint name="NotBlank">
		<option name="payload">
		<value key="severity">error</value>
		</option>
		</constraint>
		</property>
		<property name="password">
		<constraint name="NotBlank">
		<option name="payload">
		<value key="severity">error</value>
		</option>
		</constraint>
		</property>
		<property name="bankAccountNumber">
		<constraint name="Iban">
		<option name="payload">
		<value key="severity">warning</value>
		</option>
		</constraint>
		</property>
		</class>
		</constraint-mapping>

		.. code-block:: php

		// src/AppBundle/Entity/User.php
		namespace AppBundle\Entity;

		use Symfony\Component\Validator\Mapping\ClassMetadata;
		use Symfony\Component\Validator\Constraints as Assert;

		class User
		{
		public static function loadValidatorMetadata(ClassMetadata $metadata)
		{
		$metadata->addPropertyConstraint('username', new Assert\NotBlank(array(
		'payload' => array('severity' => 'error'),
		)));
		$metadata->addPropertyConstraint('password', new Assert\NotBlank(array(
		'payload' => array('severity' => 'error'),
		)));
		$metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban(array(
		'payload' => array('severity' => 'warning'),
		)));
		}
		}

		2. Customize the Error Message Template
		---------------------------------------

		.. versionadded:: 2.6
		The ``getConstraint()`` method in the ``ConstraintViolation`` class was
		introduced in Symfony 2.6.

		When validating the ``User`` object failed, you can retrieve the constraint
		that caused a particular failure using the
		:method:`Symfony\\Component\\Validator\\ConstraintViolation::getConstraint`
		method. Each constraint exposes the attached payload as a public property::
Copy link Contributor timglabischMar 8, 2015 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. one`:` to much? Copy link MemberAuthor xabbuhMar 8, 2015 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. The double colon is a shortcut for the default language so that you don't need to add a`code-block` directive.

		// a constraint validation failure, instance of
		// Symfony\Component\Validator\ConstraintViolation
		$constraintViolation = ...;
		$constraint = $constraintViolation->getConstraint();
		$severity = isset($constraint->payload['severity']) ? $constraint->payload['severity'] : null;

		For example, you can leverage this to customize the ``form_errors`` block
		such that the severity is added as an additional HTML class:

		.. code-block:: html+jinja

		{%- block form_errors -%}
		{%- if errors\|length > 0 -%}
		<ul>
		{%- for error in errors -%}
		{% if error.cause.constraint.payload.severity is defined %}
		{% set severity = error.cause.constraint.payload.severity %}
		{% endif %}
		<li{% if severity is defined %} class="{{ severity }}"{% endif %}>{{ error.message }}</li>
		{%- endfor -%}
		</ul>
		{%- endif -%}
		{%- endblock form_errors -%}
Original file line number	Diff line number	Diff line change
Expand Up		@@ -8,6 +8,7 @@ you to apply a collection of constraints to each element of the array.
		\| Applies to \| :ref:`property or method <validation-property-target>` \|
		+----------------+------------------------------------------------------------------------+
		\| Options \| - `constraints`_ \|
		\| \| - `payload`_ \|
		+----------------+------------------------------------------------------------------------+
		\| Class \| :class:`Symfony\\Component\\Validator\\Constraints\\All` \|
		+----------------+------------------------------------------------------------------------+
Expand DownExpand Up		@@ -107,3 +108,5 @@ constraints

		This required option is the array of validation constraints that you want
		to apply to each element of the underlying array.

		.. include:: /reference/constraints/_payload-option.rst.inc
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,6 +10,7 @@ blank, see :doc:`/reference/constraints/NotBlank`.
		\| Applies to \| :ref:`property or method <validation-property-target>` \|
		+----------------+-----------------------------------------------------------------------+
		\| Options \| - `message`_ \|
		\| \| - `payload`_ \|
		+----------------+-----------------------------------------------------------------------+
		\| Class \| :class:`Symfony\\Component\\Validator\\Constraints\\Blank` \|
		+----------------+-----------------------------------------------------------------------+
Expand DownExpand Up		@@ -87,3 +88,5 @@ message
		type: ``string`` default: ``This value should be blank.``

		This is the message that will be shown if the value is not blank.

		.. include:: /reference/constraints/_payload-option.rst.inc
Original file line number	Diff line number	Diff line change
Expand Up		@@ -26,6 +26,7 @@ can do anything, including creating and assigning validation errors.
		\| Applies to \| :ref:`class <validation-class-target>` \|
		+----------------+------------------------------------------------------------------------+
		\| Options \| - :ref:`callback <callback-option>` \|
		\| \| - `payload`_ \|
		+----------------+------------------------------------------------------------------------+
		\| Class \| :class:`Symfony\\Component\\Validator\\Constraints\\Callback` \|
		+----------------+------------------------------------------------------------------------+
Expand DownExpand Up		@@ -302,3 +303,5 @@ instance as only argument.
		Static or closure callbacks receive the validated object as the first argument
		and the :class:`Symfony\\Component\\Validator\\ExecutionContextInterface`
		instance as the second argument.

		.. include:: /reference/constraints/_payload-option.rst.inc
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,6 +10,7 @@ through a payment gateway.
		+----------------+--------------------------------------------------------------------------+
		\| Options \| - `schemes`_ \|
		\| \| - `message`_ \|
		\| \| - `payload`_ \|
		+----------------+--------------------------------------------------------------------------+
		\| Class \| :class:`Symfony\\Component\\Validator\\Constraints\\CardScheme` \|
		+----------------+--------------------------------------------------------------------------+
Expand DownExpand Up		@@ -124,4 +125,6 @@ message

		The message shown when the value does not pass the ``CardScheme`` check.

		.. include:: /reference/constraints/_payload-option.rst.inc

		.. _`Wikipedia: Issuer identification number (IIN)`: http://en.wikipedia.org/wiki/Bank_card_number#Issuer_identification_number_.28IIN.29
Original file line number	Diff line number	Diff line change
Expand Up		@@ -18,6 +18,7 @@ an array of items is one of those valid choices.
		\| \| - `minMessage`_ \|
		\| \| - `maxMessage`_ \|
		\| \| - `strict`_ \|
		\| \| - `payload`_ \|
		+----------------+-----------------------------------------------------------------------+
		\| Class \| :class:`Symfony\\Component\\Validator\\Constraints\\Choice` \|
		+----------------+-----------------------------------------------------------------------+
Expand DownExpand Up		@@ -89,11 +90,11 @@ If your valid choice list is simple, you can pass them in directly via the

		use Symfony\Component\Validator\Mapping\ClassMetadata;
		use Symfony\Component\Validator\Constraints as Assert;


		class Author
		{
		protected $gender;


		public static function loadValidatorMetadata(ClassMetadata $metadata)
		{
		$metadata->addPropertyConstraint('gender', new Assert\Choice(array(
Expand DownExpand Up		@@ -176,11 +177,11 @@ constraint.

		use Symfony\Component\Validator\Mapping\ClassMetadata;
		use Symfony\Component\Validator\Constraints as Assert;


		class Author
		{
		protected $gender;


		public static function loadValidatorMetadata(ClassMetadata $metadata)
		{
		$metadata->addPropertyConstraint('gender', new Assert\Choice(array(
Expand DownExpand Up		@@ -244,11 +245,11 @@ you can pass the class name and the method as an array.

		use Symfony\Component\Validator\Mapping\ClassMetadata;
		use Symfony\Component\Validator\Constraints as Assert;


		class Author
		{
		protected $gender;


		public static function loadValidatorMetadata(ClassMetadata $metadata)
		{
		$metadata->addPropertyConstraint('gender', new Assert\Choice(array(
Expand DownExpand Up		@@ -349,3 +350,5 @@ strict
		If true, the validator will also check the type of the input value. Specifically,
		this value is passed to as the third argument to the PHP :phpfunction:`in_array` method
		when checking to see if a value is in the valid choices array.

		.. include:: /reference/constraints/_payload-option.rst.inc
Original file line number	Diff line number	Diff line change
Expand Up		@@ -18,6 +18,7 @@ and that extra keys are not present.
		\| \| - `extraFieldsMessage`_ \|
		\| \| - `allowMissingFields`_ \|
		\| \| - `missingFieldsMessage`_ \|
		\| \| - `payload`_ \|
		+----------------+--------------------------------------------------------------------------+
		\| Class \| :class:`Symfony\\Component\\Validator\\Constraints\\Collection` \|
		+----------------+--------------------------------------------------------------------------+
Expand DownExpand Up		@@ -328,3 +329,5 @@ missingFieldsMessage

		The message shown if `allowMissingFields`_ is false and one or more fields
		are missing from the underlying collection.

		.. include:: /reference/constraints/_payload-option.rst.inc
Original file line number	Diff line number	Diff line change
Expand Up		@@ -12,6 +12,7 @@ element count is between some minimum and maximum value.
		\|\| - `minMessage`_\|
		\|\| - `maxMessage`_\|
		\|\| - `exactMessage`_\|
		\|\| - `payload`_\|
		+----------------+---------------------------------------------------------------------+
		\| Class\|:class:`Symfony\\Component\\Validator\\Constraints\\Count`\|
		+----------------+---------------------------------------------------------------------+
Expand DownExpand Up		@@ -139,3 +140,5 @@ exactMessage

		The message that will be shown if min and max values are equal and the underlying collection elements
		count is not exactly this value.

		..include::/reference/constraints/_payload-option.rst.inc