UPDATE

Author: tamedevelopers

Process/Concerns/SessionInterface.php

@@ -66,7 +66,9 @@ public function all(): array;
 
     /**
      * Destroy the session and clear stored data.
+     * If a key is provided, only that key is removed.
+     * @param string|null $key
      * @return void
      */
-    public function destroy(): void;
+    public function destroy(?string $key = null): void;
 }

Process/Session.php

@@ -9,14 +9,69 @@
 /**
  * Native PHP session implementation for SessionInterface.
  */
+/**
+ * Native PHP session implementation for SessionInterface.
+ * Supports optional configuration via configure() before start().
+ */
 final class Session implements SessionInterface
 {
+    /** @var array<string,mixed> */
+    private array $config = [];
+
+    /**
+     * Configure session behavior (call before start()).
+     * Supported keys: name, expire, path, cookie (array params for session_set_cookie_params), env
+     * - path: when provided, ensures directory exists and sets session.save_path
+     * - expire: accepts integer seconds
+     */
+    public function configure(array $config = []): void
+    {
+        $this->config = $config + $this->config;
+    }
+
     /** @inheritDoc */
     public function start(): void
     {
-        if (session_status() !== PHP_SESSION_ACTIVE) {
-            @session_start();
+        if (session_status() === PHP_SESSION_ACTIVE) {
+            return;
+        }
+
+        $cfg = $this->applyDefaults($this->config);
+
+        // Name
+        if (!empty($cfg['name']) && is_string($cfg['name'])) {
+            @session_name($cfg['name']);
         }
+
+        // Cookie params
+        if (!empty($cfg['expire'])) {
+            $lifetime = (int) $cfg['expire'];
+            $cookie = $cfg['cookie'] ?? [
+                'lifetime' => $lifetime,
+                'path' => '/',
+                'domain' => '',
+                'secure' => false,
+                'httponly' => true,
+                'samesite' => 'Lax',
+            ];
+            @session_set_cookie_params($cookie);
+            @ini_set('session.gc_maxlifetime', (string) $lifetime);
+            @ini_set('session.gc_probability', '1');
+            @ini_set('session.gc_divisor', '100');
+        }
+
+        // Path (create if missing)
+        if (!empty($cfg['path'])) {
+            $path = (string) $cfg['path'];
+            if (!is_dir($path)) {
+                @mkdir($path, 0777, true);
+            }
+            if (is_dir($path)) {
+                @ini_set('session.save_path', $path);
+            }
+        }
+
+        @session_start();
     }
 
     /** @inheritDoc */
@@ -65,11 +120,34 @@ public function all(): array
     }
 
     /** @inheritDoc */
-    public function destroy(): void
+    public function destroy(?string $key = null): void
     {
+        if ($key !== null) {
+            unset($_SESSION[$key]);
+            return;
+        }
+
         if (session_status() === PHP_SESSION_ACTIVE) {
             @session_unset();
             @session_destroy();
         }
     }
+
+    /**
+     * Apply default values similar to legacy Configuration::setSession
+     * - expire: default 10 days (in seconds)
+     * - path: defaults to storage_path('session') if available
+     */
+    private function applyDefaults(array $config): array
+    {
+        $defaults = [
+            'name' => null,
+            'expire' => 10 * 24 * 60 * 60,
+            'path' => function_exists('storage_path') ? storage_path('session') : null,
+            'cookie' => null,
+            'env' => function_exists('env') ? env('APP_ENV', 'production') : 'production',
+        ];
+
+        return $config + $defaults;
+    }
 }

Process/Session/Handlers/DatabaseSessionHandler.php

@@ -9,14 +9,28 @@
 
 /**
  * PDO-backed session handler.
- * Creates table structure if missing (simple schema).
+ *
+ * Responsibilities:
+ * - Persist session data in an SQL table with columns: id, payload, last_activity
+ * - Auto-create the table if it does not exist (simple schema)
+ * - Enforce TTL by filtering reads and running GC
  */
 final class DatabaseSessionHandler implements SessionHandlerInterface
 {
+    /** @var PDO PDO connection used for session persistence */
     private PDO $pdo;
+
+    /** @var string Database table name storing sessions */
     private string $table;
+
+    /** @var int Session TTL in seconds used for reads and GC */
     private int $ttl;
 
+    /**
+     * @param PDO $pdo Active PDO connection
+     * @param string $table Table name to use (default: sessions)
+     * @param int $ttl Time-to-live in seconds (default: 1440)
+     */
     public function __construct(PDO $pdo, string $table = 'sessions', int $ttl = 1440)
     {
         $this->pdo = $pdo;
@@ -25,6 +39,11 @@ public function __construct(PDO $pdo, string $table = 'sessions', int $ttl = 144
         $this->createTableIfMissing();
     }
 
+    /**
+     * Create the sessions table if it does not exist.
+     * Columns: id (PK), payload (BLOB/TEXT), last_activity (INT timestamp)
+     * @return void
+     */
     private function createTableIfMissing(): void
     {
         $sql = "CREATE TABLE IF NOT EXISTS {$this->table} (
@@ -35,9 +54,13 @@ private function createTableIfMissing(): void
         $this->pdo->exec($sql);
     }
 
+    /** @inheritDoc */
     public function open($savePath, $sessionName): bool { return true; }
+
+    /** @inheritDoc */
     public function close(): bool { return true; }
 
+    /** @inheritDoc */
     public function read($id): string|false
     {
         $stmt = $this->pdo->prepare("SELECT payload FROM {$this->table} WHERE id = :id AND last_activity > :exp");
@@ -49,6 +72,7 @@ public function read($id): string|false
         return $row !== false ? (string) $row : '';
     }
 
+    /** @inheritDoc */
     public function write($id, $data): bool
     {
         $stmt = $this->pdo->prepare("REPLACE INTO {$this->table} (id, payload, last_activity) VALUES (:id, :payload, :time)");
@@ -59,12 +83,14 @@ public function write($id, $data): bool
         ]);
     }
 
+    /** @inheritDoc */
     public function destroy($id): bool
     {
         $stmt = $this->pdo->prepare("DELETE FROM {$this->table} WHERE id = :id");
         return $stmt->execute([':id' => $id]);
     }
 
+    /** @inheritDoc */
     public function gc($max_lifetime): int|false
     {
         $stmt = $this->pdo->prepare("DELETE FROM {$this->table} WHERE last_activity < :exp");

Process/Session/Handlers/RedisSessionHandler.php

@@ -4,18 +4,36 @@
 
 namespace Tamedevelopers\Support\Process\Session\Handlers;
 
-use Redis;
 use SessionHandlerInterface;
 
 /**
  * Redis-backed session handler using phpredis.
+ *
+ * Responsibilities:
+ * - Store session payload in Redis with a key prefix and TTL
+ * - Use SETEX to ensure automatic expiration
+ * - Avoid hard type declarations for Redis to satisfy IDEs when extension is missing
  */
 final class RedisSessionHandler implements SessionHandlerInterface
 {
-    private Redis $redis;
+    /** @var object Underlying phpredis client instance */
+    private $redis;
+
+    /** @var string Key prefix for all session entries */
     private string $prefix;
+
+    /** @var int Time-to-live in seconds for session entries */
     private int $ttl;
 
+    /**
+     * @param string $host Redis host (default: 127.0.0.1)
+     * @param int $port Redis port (default: 6379)
+     * @param float $timeout Connection timeout in seconds (default: 1.5)
+     * @param mixed $auth Password or array for ACL auth (optional)
+     * @param int $database Redis database index (default: 0)
+     * @param string $prefix Key prefix for session entries (default: sess:)
+     * @param int $ttl TTL in seconds for session data (default: 1440)
+     */
     public function __construct(
         string $host = '127.0.0.1',
         int $port = 6379,
@@ -25,7 +43,8 @@ public function __construct(
         string $prefix = 'sess:',
         int $ttl = 1440
     ) {
-        $this->redis = new Redis();
+        // Avoid hard typehint to keep IDE analyzers happy when extension is missing
+        $this->redis = new \Redis();
         $this->redis->connect($host, $port, $timeout);
         if ($auth !== null && $auth !== '') {
             $this->redis->auth($auth);

Process/SessionManager.php

@@ -9,21 +9,27 @@
 use Tamedevelopers\Support\Process\Concerns\SessionInterface as BaseSessionInterface;
 use Tamedevelopers\Support\Process\Session\Handlers\DatabaseSessionHandler;
 use Tamedevelopers\Support\Process\Session\Handlers\RedisSessionHandler;
-use Redis;
 
 /**
  * Configurable session manager supporting file, database, and redis drivers.
+ *
+ * Responsibilities:
+ * - Configure PHP sessions based on a chosen driver
+ * - For file driver, ensure the directory exists (defaults to storage_path('session'))
+ * - For database driver, install a PDO-backed handler
+ * - For redis driver, install a phpredis-backed handler with TTL
+ * - Provide a simple, framework-agnostic SessionInterface implementation
  */
 final class SessionManager implements BaseSessionInterface
 {
-    /** @var array<string,mixed> */
+    /** @var array<string,mixed> Resolved session configuration */
     private array $config;
 
     /**
      * @param array<string,mixed> $config
-     *  - driver: file|database|redis|native (default: native)
+     *  - driver: file|files|database|redis|native (default: native)
      *  - lifetime: int seconds (optional, default from ini)
-     *  - path: string for file driver (optional)
+     *  - path: string for file driver (optional; defaults to storage_path('session') when available)
      *  - database: [dsn, username, password, options(array), table(string)]
      *  - redis: [host, port, timeout, auth, database, prefix, ttl]
      */
@@ -47,10 +53,20 @@ public function start(): void
             @ini_set('session.gc_maxlifetime', (string) $lifetime);
         }
 
+        // default path to storage_path('sessions') if not provided for file driver
+        if (in_array($driver, ['file', 'files'], true)) {
+            if (empty($this->config['path']) && function_exists('storage_path')) {
+                $this->config['path'] = storage_path('sessions');
+            }
+        }
+
         switch ($driver) {
             case 'file':
                 $this->configureFileDriver();
                 break;
+            case 'files': // alias
+                $this->configureFileDriver();
+                break;
             case 'database':
                 $this->configureDatabaseDriver($lifetime);
                 break;
@@ -166,8 +182,13 @@ public function all(): array
     }
 
     /** @inheritDoc */
-    public function destroy(): void
+    public function destroy(?string $key = null): void
     {
+        if ($key !== null) {
+            unset($_SESSION[$key]);
+            return;
+        }
+
         if (session_status() === PHP_SESSION_ACTIVE) {
             @session_unset();
             @session_destroy();

README.md

@@ -250,7 +250,7 @@ Support Package For PHP and Laravel
     * [host](#host)
     * [full](#full)
     * [path](#path)
-    * [server](#server)
+    * [server](#http-server)
     * [request](#request)
     * [referral](#referral)
 * [Cookie](#cookie)

Tests/session_file_driver.php

@@ -8,12 +8,14 @@
 $sessionPath = __DIR__ . '/../storage/sessions';
 $session = new SessionManager([
     'driver' => 'file',
-    'path' => $sessionPath,
+    // If omitted, defaults to storage_path('session')
+    // 'path' => $sessionPath,
     'lifetime' => 1800,
 ]);
 
 $session->start();
 $session->put('foo', 'bar');
+$session->destroy('foo');
 
 echo 'Session ID: ' . $session->id() . PHP_EOL;
-echo 'foo=' . $session->get('foo') . PHP_EOL;
+echo 'foo=' . var_export($session->get('foo'), true) . PHP_EOL;