Firewall.php

<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Security\Http;

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpKernel\Event\ExceptionEvent;
use Symfony\Component\HttpKernel\Event\FinishRequestEvent;
use Symfony\Component\HttpKernel\Event\RequestEvent;
use Symfony\Component\HttpKernel\KernelEvents;
use Symfony\Component\Security\Http\Firewall\ExceptionListener;
use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;

/**
 * Firewall uses a FirewallMap to register security listeners for the given
 * request.
 *
 * It allows for different security strategies within the same application
 * (a Basic authentication for the /api, and a web based authentication for
 * everything else for instance).
 *
 * @author Fabien Potencier <fabien@symfony.com>
 */
class Firewall implements EventSubscriberInterface
{
    /**
     * @var \SplObjectStorage<Request, ExceptionListener>
     */
    private \SplObjectStorage $exceptionListeners;

    /**
     * @param EventDispatcherInterface|null $dispatcher Passing a dispatcher is deprecated since Symfony 8.2
     */
    public function __construct(
        private FirewallMapInterface $map,
        ?EventDispatcherInterface $dispatcher = null,
    ) {
        if (null !== $dispatcher) {
            trigger_deprecation('symfony/security-http', '8.2', 'Passing an event dispatcher to "%s()" is deprecated, the argument will be removed in 9.0.', __METHOD__);
        }

        $this->exceptionListeners = new \SplObjectStorage();
    }

    public function onKernelRequest(RequestEvent $event): void
    {
        if (!$event->isMainRequest()) {
            return;
        }

        // register listeners for this firewall
        $listeners = $this->map->getListeners($event->getRequest());

        $authenticationListeners = $listeners[0];
        $exceptionListener = $listeners[1];
        $logoutListener = $listeners[2];

        if (null !== $exceptionListener) {
            $this->exceptionListeners[$event->getRequest()] = $exceptionListener;
        }

        // Authentication listeners are pre-sorted by SortFirewallListenersPass
        $authenticationListeners = static function () use ($authenticationListeners, $logoutListener) {
            if (null !== $logoutListener) {
                $logoutListenerPriority = $logoutListener::getPriority();
            }

            foreach ($authenticationListeners as $listener) {
                // Yielding the LogoutListener at the correct position
                if (null !== $logoutListener && $listener::getPriority() < $logoutListenerPriority) {
                    yield $logoutListener;
                    $logoutListener = null;
                }

                yield $listener;
            }

            // When LogoutListener has the lowest priority of all listeners
            if (null !== $logoutListener) {
                yield $logoutListener;
            }
        };

        $this->callListeners($event, $authenticationListeners());
    }

    public function onKernelException(ExceptionEvent $event): void
    {
        foreach ($this->exceptionListeners as $request) {
            $this->exceptionListeners[$request]->onKernelException($event);
        }
    }

    public function onKernelFinishRequest(FinishRequestEvent $event): void
    {
        unset($this->exceptionListeners[$event->getRequest()]);
    }

    public static function getSubscribedEvents(): array
    {
        return [
            KernelEvents::REQUEST => ['onKernelRequest', 8],
            KernelEvents::EXCEPTION => ['onKernelException', 1],
            KernelEvents::FINISH_REQUEST => 'onKernelFinishRequest',
        ];
    }

    protected function callListeners(RequestEvent $event, iterable $listeners): void
    {
        foreach ($listeners as $listener) {
            if (false === $listener->supports($event->getRequest())) {
                continue;
            }

            $listener->authenticate($event);

            if ($event->hasResponse()) {
                break;
            }
        }
    }
}