feature #12822 [Validation] Mention the option to pass stringable objects (javiereguiluz)

OskarStark · OskarStark · commit 444d03e6994e · 2019-12-17T11:19:13.000+01:00
This PR was merged into the 4.4 branch. Discussion ---------- [Validation] Mention the option to pass stringable objects Fixes #12123. Commits ------- b7b52ab [Validation] Mention the option to pass stringable objects
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
@@ -85,13 +85,19 @@ The validator class is also simple, and only has one required method ``validate(
             }
 
             if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
+                // the argument must be a string or an object implementing __toString()
                 $this->context->buildViolation($constraint->message)
                     ->setParameter('{{ string }}', $value)
                     ->addViolation();
             }
         }
     }
 
+.. versionadded:: 4.4
+
+    The feature to allow passing an object as the ``buildViolation()`` argument
+    was introduced in Symfony 4.4.
+
 Inside ``validate``, you don't need to return a value. Instead, you add violations
 to the validator's ``context`` property and a value will be considered valid
 if it causes no violations. The ``buildViolation()`` method takes the error

Original file line number	Diff line number	Diff line change
@@ -85,13 +85,19 @@ The validator class is also simple, and only has one required method ``validate(
`85`	`85`	`}`
`86`	`86`
`87`	`87`	`if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {`
	`88`	`+ // the argument must be a string or an object implementing __toString()`
`88`	`89`	`$this->context->buildViolation($constraint->message)`
`89`	`90`	`->setParameter('{{ string }}', $value)`
`90`	`91`	`->addViolation();`
`91`	`92`	`}`
`92`	`93`	`}`
`93`	`94`	`}`
`94`	`95`
	`96`	`+.. versionadded:: 4.4`
	`97`	`+`
	`98`	+ The feature to allow passing an object as the ``buildViolation()`` argument
	`99`	`+ was introduced in Symfony 4.4.`
	`100`	`+`
`95`	`101`	Inside ``validate``, you don't need to return a value. Instead, you add violations
`96`	`102`	to the validator's ``context`` property and a value will be considered valid
`97`	`103`	if it causes no violations. The ``buildViolation()`` method takes the error