The start of something beautiful

vendor/symfony/security-http/Session/SessionAuthenticationStrategy.php

@@ -0,0 +1,67 @@
+<?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\Session;
+
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+use Symfony\Component\Security\Csrf\TokenStorage\ClearableTokenStorageInterface;
+
+/**
+ * The default session strategy implementation.
+ *
+ * Supports the following strategies:
+ * NONE: the session is not changed
+ * MIGRATE: the session id is updated, attributes are kept
+ * INVALIDATE: the session id is updated, attributes are lost
+ *
+ * @author Johannes M. Schmitt <schmittjoh@gmail.com>
+ */
+class SessionAuthenticationStrategy implements SessionAuthenticationStrategyInterface
+{
+    public const NONE = 'none';
+    public const MIGRATE = 'migrate';
+    public const INVALIDATE = 'invalidate';
+
+    private string $strategy;
+    private ?ClearableTokenStorageInterface $csrfTokenStorage = null;
+
+    public function __construct(string $strategy, ?ClearableTokenStorageInterface $csrfTokenStorage = null)
+    {
+        $this->strategy = $strategy;
+
+        if (self::MIGRATE === $strategy) {
+            $this->csrfTokenStorage = $csrfTokenStorage;
+        }
+    }
+
+    public function onAuthentication(Request $request, TokenInterface $token): void
+    {
+        switch ($this->strategy) {
+            case self::NONE:
+                return;
+
+            case self::MIGRATE:
+                $request->getSession()->migrate(true);
+                $this->csrfTokenStorage?->clear();
+
+                return;
+
+            case self::INVALIDATE:
+                $request->getSession()->invalidate();
+
+                return;
+
+            default:
+                throw new \RuntimeException(sprintf('Invalid session authentication strategy "%s".', $this->strategy));
+        }
+    }
+}