vendor/symfony/event-dispatcher/EventDispatcher.php line 221

  1. <?php
  2. /*
  3.  * This file is part of the Symfony package.
  4.  *
  5.  * (c) Fabien Potencier <fabien@symfony.com>
  6.  *
  7.  * For the full copyright and license information, please view the LICENSE
  8.  * file that was distributed with this source code.
  9.  */
  10. namespace Symfony\Component\EventDispatcher;
  11. use Psr\EventDispatcher\StoppableEventInterface;
  12. use Symfony\Component\EventDispatcher\Debug\WrappedListener;
  13. /**
  14.  * The EventDispatcherInterface is the central point of Symfony's event listener system.
  15.  *
  16.  * Listeners are registered on the manager and events are dispatched through the
  17.  * manager.
  18.  *
  19.  * @author Guilherme Blanco <guilhermeblanco@hotmail.com>
  20.  * @author Jonathan Wage <jonwage@gmail.com>
  21.  * @author Roman Borschel <roman@code-factory.org>
  22.  * @author Bernhard Schussek <bschussek@gmail.com>
  23.  * @author Fabien Potencier <fabien@symfony.com>
  24.  * @author Jordi Boggiano <j.boggiano@seld.be>
  25.  * @author Jordan Alliot <jordan.alliot@gmail.com>
  26.  * @author Nicolas Grekas <p@tchwork.com>
  27.  */
  28. class EventDispatcher implements EventDispatcherInterface
  29. {
  30.     private array $listeners = [];
  31.     private array $sorted = [];
  32.     private array $optimized;
  33.     public function __construct()
  34.     {
  35.         if (__CLASS__ === static::class) {
  36.             $this->optimized = [];
  37.         }
  38.     }
  39.     public function dispatch(object $eventstring $eventName null): object
  40.     {
  41.         $eventName ??= $event::class;
  42.         if (isset($this->optimized)) {
  43.             $listeners $this->optimized[$eventName] ?? (empty($this->listeners[$eventName]) ? [] : $this->optimizeListeners($eventName));
  44.         } else {
  45.             $listeners $this->getListeners($eventName);
  46.         }
  47.         if ($listeners) {
  48.             $this->callListeners($listeners$eventName$event);
  49.         }
  50.         return $event;
  51.     }
  52.     public function getListeners(string $eventName null): array
  53.     {
  54.         if (null !== $eventName) {
  55.             if (empty($this->listeners[$eventName])) {
  56.                 return [];
  57.             }
  58.             if (!isset($this->sorted[$eventName])) {
  59.                 $this->sortListeners($eventName);
  60.             }
  61.             return $this->sorted[$eventName];
  62.         }
  63.         foreach ($this->listeners as $eventName => $eventListeners) {
  64.             if (!isset($this->sorted[$eventName])) {
  65.                 $this->sortListeners($eventName);
  66.             }
  67.         }
  68.         return array_filter($this->sorted);
  69.     }
  70.     public function getListenerPriority(string $eventName, callable|array $listener): ?int
  71.     {
  72.         if (empty($this->listeners[$eventName])) {
  73.             return null;
  74.         }
  75.         if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && >= \count($listener)) {
  76.             $listener[0] = $listener[0]();
  77.             $listener[1] ??= '__invoke';
  78.         }
  79.         foreach ($this->listeners[$eventName] as $priority => &$listeners) {
  80.             foreach ($listeners as &$v) {
  81.                 if ($v !== $listener && \is_array($v) && isset($v[0]) && $v[0] instanceof \Closure && >= \count($v)) {
  82.                     $v[0] = $v[0]();
  83.                     $v[1] ??= '__invoke';
  84.                 }
  85.                 if ($v === $listener || ($listener instanceof \Closure && $v == $listener)) {
  86.                     return $priority;
  87.                 }
  88.             }
  89.         }
  90.         return null;
  91.     }
  92.     public function hasListeners(string $eventName null): bool
  93.     {
  94.         if (null !== $eventName) {
  95.             return !empty($this->listeners[$eventName]);
  96.         }
  97.         foreach ($this->listeners as $eventListeners) {
  98.             if ($eventListeners) {
  99.                 return true;
  100.             }
  101.         }
  102.         return false;
  103.     }
  104.     public function addListener(string $eventName, callable|array $listenerint $priority 0)
  105.     {
  106.         $this->listeners[$eventName][$priority][] = $listener;
  107.         unset($this->sorted[$eventName], $this->optimized[$eventName]);
  108.     }
  109.     public function removeListener(string $eventName, callable|array $listener)
  110.     {
  111.         if (empty($this->listeners[$eventName])) {
  112.             return;
  113.         }
  114.         if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && >= \count($listener)) {
  115.             $listener[0] = $listener[0]();
  116.             $listener[1] ??= '__invoke';
  117.         }
  118.         foreach ($this->listeners[$eventName] as $priority => &$listeners) {
  119.             foreach ($listeners as $k => &$v) {
  120.                 if ($v !== $listener && \is_array($v) && isset($v[0]) && $v[0] instanceof \Closure && >= \count($v)) {
  121.                     $v[0] = $v[0]();
  122.                     $v[1] ??= '__invoke';
  123.                 }
  124.                 if ($v === $listener || ($listener instanceof \Closure && $v == $listener)) {
  125.                     unset($listeners[$k], $this->sorted[$eventName], $this->optimized[$eventName]);
  126.                 }
  127.             }
  128.             if (!$listeners) {
  129.                 unset($this->listeners[$eventName][$priority]);
  130.             }
  131.         }
  132.     }
  133.     public function addSubscriber(EventSubscriberInterface $subscriber)
  134.     {
  135.         foreach ($subscriber->getSubscribedEvents() as $eventName => $params) {
  136.             if (\is_string($params)) {
  137.                 $this->addListener($eventName, [$subscriber$params]);
  138.             } elseif (\is_string($params[0])) {
  139.                 $this->addListener($eventName, [$subscriber$params[0]], $params[1] ?? 0);
  140.             } else {
  141.                 foreach ($params as $listener) {
  142.                     $this->addListener($eventName, [$subscriber$listener[0]], $listener[1] ?? 0);
  143.                 }
  144.             }
  145.         }
  146.     }
  147.     public function removeSubscriber(EventSubscriberInterface $subscriber)
  148.     {
  149.         foreach ($subscriber->getSubscribedEvents() as $eventName => $params) {
  150.             if (\is_array($params) && \is_array($params[0])) {
  151.                 foreach ($params as $listener) {
  152.                     $this->removeListener($eventName, [$subscriber$listener[0]]);
  153.                 }
  154.             } else {
  155.                 $this->removeListener($eventName, [$subscriber\is_string($params) ? $params $params[0]]);
  156.             }
  157.         }
  158.     }
  159.     /**
  160.      * Triggers the listeners of an event.
  161.      *
  162.      * This method can be overridden to add functionality that is executed
  163.      * for each listener.
  164.      *
  165.      * @param callable[] $listeners The event listeners
  166.      * @param string     $eventName The name of the event to dispatch
  167.      * @param object     $event     The event object to pass to the event handlers/listeners
  168.      */
  169.     protected function callListeners(iterable $listenersstring $eventNameobject $event)
  170.     {
  171.         $stoppable $event instanceof StoppableEventInterface;
  172.         foreach ($listeners as $listener) {
  173.             if ($stoppable && $event->isPropagationStopped()) {
  174.                 break;
  175.             }
  176.             $listener($event$eventName$this);
  177.         }
  178.     }
  179.     /**
  180.      * Sorts the internal list of listeners for the given event by priority.
  181.      */
  182.     private function sortListeners(string $eventName)
  183.     {
  184.         krsort($this->listeners[$eventName]);
  185.         $this->sorted[$eventName] = [];
  186.         foreach ($this->listeners[$eventName] as &$listeners) {
  187.             foreach ($listeners as &$listener) {
  188.                 if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && >= \count($listener)) {
  189.                     $listener[0] = $listener[0]();
  190.                     $listener[1] ??= '__invoke';
  191.                 }
  192.                 $this->sorted[$eventName][] = $listener;
  193.             }
  194.         }
  195.     }
  196.     /**
  197.      * Optimizes the internal list of listeners for the given event by priority.
  198.      */
  199.     private function optimizeListeners(string $eventName): array
  200.     {
  201.         krsort($this->listeners[$eventName]);
  202.         $this->optimized[$eventName] = [];
  203.         foreach ($this->listeners[$eventName] as &$listeners) {
  204.             foreach ($listeners as &$listener) {
  205.                 $closure = &$this->optimized[$eventName][];
  206.                 if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && >= \count($listener)) {
  207.                     $closure = static function (...$args) use (&$listener, &$closure) {
  208.                         if ($listener[0] instanceof \Closure) {
  209.                             $listener[0] = $listener[0]();
  210.                             $listener[1] ??= '__invoke';
  211.                         }
  212.                         ($closure $listener(...))(...$args);
  213.                     };
  214.                 } else {
  215.                     $closure $listener instanceof WrappedListener $listener $listener(...);
  216.                 }
  217.             }
  218.         }
  219.         return $this->optimized[$eventName];
  220.     }
  221. }