feat(session): implement PSR-16 cache based session storage

Author: lvluoyue

composer.json

@@ -27,6 +27,7 @@
     "psr/event-dispatcher": "^1.0",
     "psr/http-factory": "^1.1",
     "psr/http-message": "^2.0",
+    "psr/simple-cache": "^3.0",
     "psr/log": "^1.0 || ^2.0 || ^3.0",
     "symfony/finder": "^6.4 || ^7.3 || ^8.0",
     "symfony/uid": "^6.4 || ^7.3 || ^8.0"
@@ -36,7 +37,6 @@
     "phpstan/phpstan": "^2.1",
     "phpunit/phpunit": "^10.5",
     "psr/cache": "^3.0",
-    "psr/simple-cache": "^3.0",
     "symfony/cache": "^6.4 || ^7.3 || ^8.0",
     "symfony/console": "^6.4 || ^7.3 || ^8.0",
     "symfony/process": "^6.4 || ^7.3 || ^8.0",

src/Server/Session/Psr16StoreSession.php

@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the official PHP MCP SDK.
+ *
+ * A collaboration between Symfony and the PHP Foundation.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Mcp\Server\Session;
+
+use Psr\SimpleCache\CacheInterface;
+use Symfony\Component\Uid\Uuid;
+
+/**
+ * PSR-16 compliant cache-based session store.
+ * 
+ * This implementation uses any PSR-16 compliant cache as the storage backend
+ * for session data. Each session is stored with a prefixed key using the session ID.
+ */
+class Psr16StoreSession implements SessionStoreInterface
+{
+    public function __construct(
+        private readonly CacheInterface $cache,
+        private readonly string $prefix = 'mcp-',
+        private readonly int $ttl = 3600,
+    ) {
+    }
+
+    public function exists(Uuid $id): bool
+    {
+        try {
+            return $this->cache->has($this->getKey($id));
+        } catch (\Throwable) {
+            return false;
+        }
+    }
+
+    public function read(Uuid $id): string|false
+    {
+        try {
+            return $this->cache->get($this->getKey($id), false);
+        } catch (\Throwable) {
+            return false;
+        }
+    }
+
+    public function write(Uuid $id, string $data): bool
+    {
+        try {
+            return $this->cache->set($this->getKey($id), $data, $this->ttl);
+        } catch (\Throwable) {
+            return false;
+        }
+    }
+
+    public function destroy(Uuid $id): bool
+    {
+        try {
+            return $this->cache->delete($this->getKey($id));
+        } catch (\Throwable) {
+            return false;
+        }
+    }
+
+    public function gc(): array
+    {
+        return [];
+    }
+
+    private function getKey(Uuid $id): string
+    {
+        return $this->prefix.$id;
+    }
+}