You are here

private function YamlFileLoader::parseDefinition in Drupal 10

Same name and namespace in other branches
  1. 8 core/lib/Drupal/Core/DependencyInjection/YamlFileLoader.php \Drupal\Core\DependencyInjection\YamlFileLoader::parseDefinition()
  2. 9 core/lib/Drupal/Core/DependencyInjection/YamlFileLoader.php \Drupal\Core\DependencyInjection\YamlFileLoader::parseDefinition()

Parses a definition.

Parameters

string $id:

array $service:

string $file:

array $defaults:

Throws

InvalidArgumentException When tags are invalid.

File

core/lib/Drupal/Core/DependencyInjection/YamlFileLoader.php, line 206

Class

YamlFileLoader
YamlFileLoader loads YAML files service definitions.

Namespace

Drupal\Core\DependencyInjection

Code

private function parseDefinition(string $id, $service, string $file, array $defaults) {
  if (\is_string($service) && 0 === strpos($service, '@')) {
    $this->container
      ->setAlias($id, $alias = new Alias(substr($service, 1)));
    if (isset($defaults['public'])) {
      $alias
        ->setPublic($defaults['public']);
    }
    return;
  }
  if (null === $service) {
    $service = [];
  }
  if (!is_array($service)) {
    throw new InvalidArgumentException(sprintf('A service definition must be an array or a string starting with "@" but %s found for service "%s" in %s. Check your YAML syntax.', gettype($service), $id, $file));
  }
  if (isset($service['alias'])) {
    $this->container
      ->setAlias($id, $alias = new Alias($service['alias']));
    if (isset($service['public'])) {
      $alias
        ->setPublic($service['public']);
    }
    elseif (isset($defaults['public'])) {
      $alias
        ->setPublic($defaults['public']);
    }
    if (array_key_exists('deprecated', $service)) {
      $deprecation = \is_array($service['deprecated']) ? $service['deprecated'] : [
        'message' => $service['deprecated'],
      ];
      $alias
        ->setDeprecated($deprecation['package'] ?? '', $deprecation['version'] ?? '', $deprecation['message']);
    }
    return;
  }
  if (isset($service['parent'])) {
    $definition = new ChildDefinition($service['parent']);
  }
  else {
    $definition = new Definition();
  }

  // Drupal services are public by default.
  $definition
    ->setPublic(true);
  if (isset($defaults['public'])) {
    $definition
      ->setPublic($defaults['public']);
  }
  if (isset($defaults['autowire'])) {
    $definition
      ->setAutowired($defaults['autowire']);
  }
  $definition
    ->setChanges([]);
  if (isset($service['class'])) {
    $definition
      ->setClass($service['class']);
  }
  if (isset($service['shared'])) {
    $definition
      ->setShared($service['shared']);
  }
  if (isset($service['synthetic'])) {
    $definition
      ->setSynthetic($service['synthetic']);
  }
  if (isset($service['lazy'])) {
    $definition
      ->setLazy($service['lazy']);
  }
  if (isset($service['public'])) {
    $definition
      ->setPublic($service['public']);
  }
  if (isset($service['abstract'])) {
    $definition
      ->setAbstract($service['abstract']);
  }
  if (array_key_exists('deprecated', $service)) {
    $deprecation = \is_array($service['deprecated']) ? $service['deprecated'] : [
      'message' => $service['deprecated'],
    ];
    $definition
      ->setDeprecated($deprecation['package'] ?? '', $deprecation['version'] ?? '', $deprecation['message']);
  }
  if (isset($service['factory'])) {
    if (is_string($service['factory'])) {
      if (strpos($service['factory'], ':') !== false && strpos($service['factory'], '::') === false) {
        $parts = explode(':', $service['factory']);
        $definition
          ->setFactory(array(
          $this
            ->resolveServices('@' . $parts[0]),
          $parts[1],
        ));
      }
      else {
        $definition
          ->setFactory($service['factory']);
      }
    }
    else {
      $definition
        ->setFactory(array(
        $this
          ->resolveServices($service['factory'][0]),
        $service['factory'][1],
      ));
    }
  }
  if (isset($service['factory_class'])) {
    $definition
      ->setFactory($service['factory_class']);
  }
  if (isset($service['factory_method'])) {
    $definition
      ->setFactory($service['factory_method']);
  }
  if (isset($service['factory_service'])) {
    $definition
      ->setFactory($service['factory_service']);
  }
  if (isset($service['file'])) {
    $definition
      ->setFile($service['file']);
  }
  if (isset($service['arguments'])) {
    $definition
      ->setArguments($this
      ->resolveServices($service['arguments']));
  }
  if (isset($service['properties'])) {
    $definition
      ->setProperties($this
      ->resolveServices($service['properties']));
  }
  if (isset($service['configurator'])) {
    if (is_string($service['configurator'])) {
      $definition
        ->setConfigurator($service['configurator']);
    }
    else {
      $definition
        ->setConfigurator(array(
        $this
          ->resolveServices($service['configurator'][0]),
        $service['configurator'][1],
      ));
    }
  }
  if (isset($service['calls'])) {
    if (!is_array($service['calls'])) {
      throw new InvalidArgumentException(sprintf('Parameter "calls" must be an array for service "%s" in %s. Check your YAML syntax.', $id, $file));
    }
    foreach ($service['calls'] as $call) {
      if (isset($call['method'])) {
        $method = $call['method'];
        $args = isset($call['arguments']) ? $this
          ->resolveServices($call['arguments']) : array();
      }
      else {
        $method = $call[0];
        $args = isset($call[1]) ? $this
          ->resolveServices($call[1]) : array();
      }
      $definition
        ->addMethodCall($method, $args);
    }
  }
  $tags = $service['tags'] ?? [];
  if (!\is_array($tags)) {
    throw new InvalidArgumentException(sprintf('Parameter "tags" must be an array for service "%s" in "%s". Check your YAML syntax.', $id, $file));
  }
  if (isset($defaults['tags'])) {
    $tags = array_merge($tags, $defaults['tags']);
  }
  foreach ($tags as $tag) {
    if (!\is_array($tag)) {
      $tag = [
        'name' => $tag,
      ];
    }
    if (!isset($tag['name'])) {
      throw new InvalidArgumentException(sprintf('A "tags" entry is missing a "name" key for service "%s" in "%s".', $id, $file));
    }
    $name = $tag['name'];
    unset($tag['name']);
    if (!\is_string($name) || '' === $name) {
      throw new InvalidArgumentException(sprintf('The tag name for service "%s" in "%s" must be a non-empty string.', $id, $file));
    }
    foreach ($tag as $attribute => $value) {
      if (!is_scalar($value) && null !== $value) {
        throw new InvalidArgumentException(sprintf('A "tags" attribute must be of a scalar-type for service "%s", tag "%s", attribute "%s" in "%s". Check your YAML syntax.', $id, $name, $attribute, $file));
      }
    }
    $definition
      ->addTag($name, $tag);
  }
  if (isset($service['decorates'])) {
    $renameId = $service['decoration_inner_name'] ?? null;
    $priority = $service['decoration_priority'] ?? 0;
    $definition
      ->setDecoratedService($service['decorates'], $renameId, $priority);
  }
  if (isset($service['autowire'])) {
    $definition
      ->setAutowired($service['autowire']);
  }
  $this->container
    ->setDefinition($id, $definition);
}