Add a ChainUserChecker to allow calling multiple user checkers for a firewall

Author: mbabker

CHANGELOG.md

@@ -7,6 +7,7 @@ CHANGELOG
  * Deprecate the `Security` class, use `Symfony\Bundle\SecurityBundle\Security\Security` instead
  * Change the signature of `TokenStorageInterface::setToken()` to `setToken(?TokenInterface $token)`
  * Deprecate calling `TokenStorage::setToken()` without arguments
+ * Add a `ChainUserChecker` to allow calling multiple user checkers for a firewall
 
 6.0
 ---

Tests/User/ChainUserCheckerTest.php

@@ -0,0 +1,64 @@
+<?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\Core\Tests\User;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\Security\Core\User\ChainUserChecker;
+use Symfony\Component\Security\Core\User\UserCheckerInterface;
+use Symfony\Component\Security\Core\User\UserInterface;
+
+final class ChainUserCheckerTest extends TestCase
+{
+    public function testForwardsPreAuthToAllUserCheckers()
+    {
+        $user = $this->createMock(UserInterface::class);
+
+        $checker1 = $this->createMock(UserCheckerInterface::class);
+        $checker1->expects($this->once())
+            ->method('checkPreAuth')
+            ->with($user);
+
+        $checker2 = $this->createMock(UserCheckerInterface::class);
+        $checker2->expects($this->once())
+            ->method('checkPreAuth')
+            ->with($user);
+
+        $checker3 = $this->createMock(UserCheckerInterface::class);
+        $checker3->expects($this->once())
+            ->method('checkPreAuth')
+            ->with($user);
+
+        (new ChainUserChecker([$checker1, $checker2, $checker3]))->checkPreAuth($user);
+    }
+
+    public function testForwardsPostAuthToAllUserCheckers()
+    {
+        $user = $this->createMock(UserInterface::class);
+
+        $checker1 = $this->createMock(UserCheckerInterface::class);
+        $checker1->expects($this->once())
+            ->method('checkPostAuth')
+            ->with($user);
+
+        $checker2 = $this->createMock(UserCheckerInterface::class);
+        $checker2->expects($this->once())
+            ->method('checkPostAuth')
+            ->with($user);
+
+        $checker3 = $this->createMock(UserCheckerInterface::class);
+        $checker3->expects($this->once())
+            ->method('checkPostAuth')
+            ->with($user);
+
+        (new ChainUserChecker([$checker1, $checker2, $checker3]))->checkPostAuth($user);
+    }
+}

User/ChainUserChecker.php

@@ -0,0 +1,36 @@
+<?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\Core\User;
+
+final class ChainUserChecker implements UserCheckerInterface
+{
+    /**
+     * @param iterable<UserCheckerInterface> $checkers
+     */
+    public function __construct(private readonly iterable $checkers)
+    {
+    }
+
+    public function checkPreAuth(UserInterface $user): void
+    {
+        foreach ($this->checkers as $checker) {
+            $checker->checkPreAuth($user);
+        }
+    }
+
+    public function checkPostAuth(UserInterface $user): void
+    {
+        foreach ($this->checkers as $checker) {
+            $checker->checkPostAuth($user);
+        }
+    }
+}