Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. ServiceLocatorTrait.php

trait ServiceLocatorTrait

A trait to help implement ServiceProviderInterface.

@author Robin Chalas <robin.chalas@gmail.com> @author Nicolas Grekas <p@tchwork.com>

Hierarchy

  • trait \Symfony\Contracts\Service\ServiceLocatorTrait
2 files declare their use of ServiceLocatorTrait
ServiceLocator.php in vendor/symfony/dependency-injection/ServiceLocator.php
ServiceLocatorTestCase.php in vendor/symfony/service-contracts/Test/ServiceLocatorTestCase.php

File

vendor/symfony/service-contracts/ServiceLocatorTrait.php, line 27

Namespace

Symfony\Contracts\Service
View source
trait ServiceLocatorTrait {
    private array $factories;
    private array $loading = [];
    private array $providedTypes;
    
    /**
     * @param array<string, callable> $factories
     */
    public function __construct(array $factories) {
        $this->factories = $factories;
    }
    public function has(string $id) : bool {
        return isset($this->factories[$id]);
    }
    public function get(string $id) : mixed {
        if (!isset($this->factories[$id])) {
            throw $this->createNotFoundException($id);
        }
        if (isset($this->loading[$id])) {
            $ids = array_values($this->loading);
            $ids = \array_slice($this->loading, array_search($id, $ids));
            $ids[] = $id;
            throw $this->createCircularReferenceException($id, $ids);
        }
        $this->loading[$id] = $id;
        try {
            return $this->factories[$id]($this);
        } finally {
            unset($this->loading[$id]);
        }
    }
    public function getProvidedServices() : array {
        if (!isset($this->providedTypes)) {
            $this->providedTypes = [];
            foreach ($this->factories as $name => $factory) {
                if (!\is_callable($factory)) {
                    $this->providedTypes[$name] = '?';
                }
                else {
                    $type = (new \ReflectionFunction($factory))->getReturnType();
                    $this->providedTypes[$name] = $type ? ($type->allowsNull() ? '?' : '') . ($type instanceof \ReflectionNamedType ? $type->getName() : $type) : '?';
                }
            }
        }
        return $this->providedTypes;
    }
    private function createNotFoundException(string $id) : NotFoundExceptionInterface {
        if (!($alternatives = array_keys($this->factories))) {
            $message = 'is empty...';
        }
        else {
            $last = array_pop($alternatives);
            if ($alternatives) {
                $message = sprintf('only knows about the "%s" and "%s" services.', implode('", "', $alternatives), $last);
            }
            else {
                $message = sprintf('only knows about the "%s" service.', $last);
            }
        }
        if ($this->loading) {
            $message = sprintf('The service "%s" has a dependency on a non-existent service "%s". This locator %s', end($this->loading), $id, $message);
        }
        else {
            $message = sprintf('Service "%s" not found: the current service locator %s', $id, $message);
        }
        return new class ($message) extends \InvalidArgumentException implements NotFoundExceptionInterface {

};
    }
    private function createCircularReferenceException(string $id, array $path) : ContainerExceptionInterface {
        return new class (sprintf('Circular reference detected for service "%s", path: "%s".', $id, implode(' -> ', $path))) extends \RuntimeException implements ContainerExceptionInterface {

};
    }

}

Members

Title Sort descending Modifiers Object type Summary Overrides
ServiceLocatorTrait::$factories private property
ServiceLocatorTrait::$loading private property
ServiceLocatorTrait::$providedTypes private property
ServiceLocatorTrait::createCircularReferenceException private function 1
ServiceLocatorTrait::createNotFoundException private function 1
ServiceLocatorTrait::get public function
ServiceLocatorTrait::getProvidedServices public function 1
ServiceLocatorTrait::has public function
ServiceLocatorTrait::__construct public function 1
RSS feed
Powered by Drupal