codemonster-ru/session

Lightweight session management library for PHP with pluggable handlers

v1.0.0 2025-10-24 14:54 UTC

Requires

• php: >=8.2

Requires (Dev)

• phpunit/phpunit: ^9.6 || ^10.5 || ^11.0 || ^12.0

MIT

• Kirill Kolesnikov

• framework
• php
• session
• handler
• codemonster

README

Lightweight session management library for PHP — object-oriented.

📦 Installation

composer require codemonster-ru/session

🚀 Usage

Basic example

use Codemonster\Session\Session;

// Start session (default: file storage)
Session::start();

// Store values
Session::put('user', 'Vasya');
Session::put('role', 'admin');

// Retrieve values
echo Session::get('user'); // Vasya

// Remove values
Session::forget('role');

// Get all session data
print_r(Session::all());

// Destroy current session
Session::destroy();

Using Array handler (for tests or CLI)

Session::start('array');
Session::put('debug', true);

echo Session::get('debug'); // true

Using custom handler

use Codemonster\Session\Session;
use App\Session\RedisSessionHandler;

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

$handler = new RedisSessionHandler($redis);

Session::start(customHandler: $handler);
Session::put('user_id', 42);

🧪 Testing

You can run tests with the command:

composer test

👨‍💻 Author

Kirill Kolesnikov

📜 License

MIT