public function LegacyExecutionContext::validate in Plug 7

Validates the given value within the scope of the current validation.

The value may be any value recognized by the used metadata factory (see {@link MetadataFactoryInterface::getMetadata}), or an array or a traversable object of such values.

Usually you validate a value that is not the current node of the execution context. For this case, you can pass the {@link $subPath} argument which is appended to the current property path when a violation is created. For example, take the following object graph:

<pre> (Person)---($address: Address)---($phoneNumber: PhoneNumber) ^ </pre>

When the execution context stops at the <tt>Person</tt> instance, the property path is "address". When you validate the <tt>PhoneNumber</tt> instance now, pass "phoneNumber" as sub path to correct the property path to "address.phoneNumber":

<pre> $context->validate($address->phoneNumber, 'phoneNumber'); </pre>

Any violations generated during the validation will be added to the violation list that you can access with {@link getViolations}.

Parameters

mixed $value The value to validate.:

string $subPath The path to append to the context's property path.:

null|string|string[] $groups The groups to validate in. If you don't pass any: groups here, the current group of the context will be used.

bool $traverse Whether to traverse the value if it is an array: or an instance of <tt>\Traversable</tt>.

bool $deep Whether to traverse the value recursively if: it is a collection of collections.

Overrides ExecutionContext::validate

File

lib/Symfony/validator/Symfony/Component/Validator/Context/LegacyExecutionContext.php, line 103

Class

LegacyExecutionContext

An execution context that is compatible with the legacy API (< 2.5).

Namespace

Symfony\Component\Validator\Context

Code

public function validate($value, $subPath = '', $groups = null, $traverse = false, $deep = false) {
  if (is_array($value)) {

    // The $traverse flag is ignored for arrays
    $constraint = new Valid(array(
      'traverse' => true,
      'deep' => $deep,
    ));
    return $this
      ->getValidator()
      ->inContext($this)
      ->atPath($subPath)
      ->validate($value, $constraint, $groups);
  }
  if ($traverse && $value instanceof \Traversable) {
    $constraint = new Valid(array(
      'traverse' => true,
      'deep' => $deep,
    ));
    return $this
      ->getValidator()
      ->inContext($this)
      ->atPath($subPath)
      ->validate($value, $constraint, $groups);
  }
  return $this
    ->getValidator()
    ->inContext($this)
    ->atPath($subPath)
    ->validate($value, null, $groups);
}