vendor/symfony/dependency-injection/Compiler/ServiceReferenceGraph.php line 77

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\DependencyInjection\Compiler;
  14. use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
  15. use Symfony\Component\DependencyInjection\Reference;
  17. /**
  18.  * This is a directed graph of your services.
  19.  *
  20.  * This information can be used by your compiler passes instead of collecting
  21.  * it themselves which improves performance quite a lot.
  22.  *
  23.  * @author Johannes M. Schmitt <schmittjoh@gmail.com>
  24.  *
  25.  * @final
  26.  */
  27. class ServiceReferenceGraph
  28. {
  29.     /**
  30.      * @var ServiceReferenceGraphNode[]
  31.      */
  32.     private array $nodes = [];
  34.     public function hasNode(string $id): bool
  35.     {
  36.         return isset($this->nodes[$id]);
  37.     }
  39.     /**
  40.      * Gets a node by identifier.
  41.      *
  42.      * @throws InvalidArgumentException if no node matches the supplied identifier
  43.      */
  44.     public function getNode(string $id): ServiceReferenceGraphNode
  45.     {
  46.         if (!isset($this->nodes[$id])) {
  47.             throw new InvalidArgumentException(sprintf('There is no node with id "%s".', $id));
  48.         }
  50.         return $this->nodes[$id];
  51.     }
  53.     /**
  54.      * Returns all nodes.
  55.      *
  56.      * @return ServiceReferenceGraphNode[]
  57.      */
  58.     public function getNodes(): array
  59.     {
  60.         return $this->nodes;
  61.     }
  63.     /**
  64.      * Clears all nodes.
  65.      */
  66.     public function clear()
  67.     {
  68.         foreach ($this->nodes as $node) {
  69.             $node->clear();
  70.         }
  71.         $this->nodes = [];
  72.     }
  74.     /**
  75.      * Connects 2 nodes together in the Graph.
  76.      */
  77.     public function connect(?string $sourceId, mixed $sourceValue, ?string $destId, mixed $destValue = null, Reference $reference = null, bool $lazy = false, bool $weak = false, bool $byConstructor = false)
  78.     {
  79.         if (null === $sourceId || null === $destId) {
  80.             return;
  81.         }
  83.         $sourceNode = $this->createNode($sourceId, $sourceValue);
  84.         $destNode = $this->createNode($destId, $destValue);
  85.         $edge = new ServiceReferenceGraphEdge($sourceNode, $destNode, $reference, $lazy, $weak, $byConstructor);
  87.         $sourceNode->addOutEdge($edge);
  88.         $destNode->addInEdge($edge);
  89.     }
  91.     private function createNode(string $id, mixed $value): ServiceReferenceGraphNode
  92.     {
  93.         if (isset($this->nodes[$id]) && $this->nodes[$id]->getValue() === $value) {
  94.             return $this->nodes[$id];
  95.         }
  97.         return $this->nodes[$id] = new ServiceReferenceGraphNode($id, $value);
  98.     }
  99. }