function ConstraintFactory::createInstance

Same name and namespace in other branches
  1. 11.x core/lib/Drupal/Core/Validation/ConstraintFactory.php \Drupal\Core\Validation\ConstraintFactory::createInstance()
  2. 10 core/lib/Drupal/Core/Validation/ConstraintFactory.php \Drupal\Core\Validation\ConstraintFactory::createInstance()
  3. 9 core/lib/Drupal/Core/Validation/ConstraintFactory.php \Drupal\Core\Validation\ConstraintFactory::createInstance()

Overrides ContainerFactory::createInstance

File

core/lib/Drupal/Core/Validation/ConstraintFactory.php, line 20

Class

ConstraintFactory
Constraint plugin factory.

Namespace

Drupal\Core\Validation

Code

public function createInstance($plugin_id, array $configuration = []) {
  if ($configuration && array_is_list($configuration)) {
    throw new \InvalidArgumentException('$configuration must be an associative array.');
  }
  $plugin_definition = $this->discovery
    ->getDefinition($plugin_id);
  $plugin_class = static::getPluginClass($plugin_id, $plugin_definition, $this->interface);
  if (is_subclass_of($plugin_class, CompositeConstraintInterface::class)) {
    $composite_constraint_options = (array) $plugin_class::getCompositeOptionStatic();
    foreach ($composite_constraint_options as $option) {
      // Skip if no constraints are set in the configuration.
      if (!isset($configuration[$option])) {
        continue;
      }
      foreach ($configuration[$option] as $key => $value) {
        foreach ($value as $nested_constraint_id => $nested_constraint_configuration) {
          $configuration[$option][$key] = $this->createInstance($nested_constraint_id, $nested_constraint_configuration);
        }
      }
    }
  }
  // If the plugin provides a factory method, pass the container to it.
  if (is_subclass_of($plugin_class, ContainerFactoryPluginInterface::class)) {
    return $plugin_class::create(\Drupal::getContainer(), $configuration, $plugin_id, $plugin_definition);
  }
  // If the plugin is a Symfony Constraint, use the correct constructor.
  if (is_subclass_of($plugin_class, Constraint::class)) {
    return new $plugin_class(...$configuration);
  }
  // Otherwise, create the plugin as normal.
  return new $plugin_class($configuration, $plugin_id, $plugin_definition);
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.