PHPackages                             jeankassio/php-redis-session-manager - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. jeankassio/php-redis-session-manager

ActiveLibrary

jeankassio/php-redis-session-manager
====================================

PHP Session handler with Redis and WebSocket compatibility

1.5(10mo ago)29MITPHPPHP >=8.1

Since Jul 10Pushed 10mo ago1 watchersCompare

[ Source](https://github.com/jeankassio/PHP-Redis-Session-Manager)[ Packagist](https://packagist.org/packages/jeankassio/php-redis-session-manager)[ RSS](/packages/jeankassio-php-redis-session-manager/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (1)Versions (9)Used By (0)

PHP Redis Session Manager
=========================

[](#php-redis-session-manager)

A simple and flexible PHP library for managing sessions using Redis, compatible with both **standard HTTP pages** and **WebSocket servers**.

---

Installation
------------

[](#installation)

You can install via Composer:

```
composer require jeankassio/php-redis-session-manager
```

What is this?
-------------

[](#what-is-this)

PHP Redis Session Manager allows you to manage PHP sessions directly with Redis, supporting both:

- Traditional HTTP requests (automatic $\_SESSION)
- WebSocket environments (manual control of session read/write/delete)

Usage
-----

[](#usage)

### For Normal PHP Pages (Non-WebSocket)

[](#for-normal-php-pages-non-websocket)

```
require_once(dirname(__FILE__) ."/vendor/autoload.php");

use JeanKassio\RedisSessionManager;

$redisSessionManager = new RedisSessionManager('127.0.0.1', 6379, 'Password'); // Password is optional

$redisSessionManager->start(); // Starts the session and sets Redis as handler

if (!$redisSessionManager->checkRedis()) {
    // Handle Redis connection failure
}

// Set session values
$_SESSION['anything'] = 'anything';

// Get session values
$anything = $_SESSION['anything'];
```

### For WebSocket Usage

[](#for-websocket-usage)

**Do not call start() inside WebSocket servers!**

```
require_once(dirname(__FILE__) ."/vendor/autoload.php");

use JeanKassio\RedisSessionManager;

$redisSessionManager = new RedisSessionManager('127.0.0.1', 6379, 'Password'); // Password is optional

// Get session ID from your WebSocket logic
$sessionId = 'your-session-id';
$redisSessionManager->setSessionId($sessionId);

// Get full session as array
$session = $redisSessionManager->getSession();

// Set session data
$newSession = [
    'anything' => 'anything',
    'data' => $data,
    'username' => 'jeankassio'
];

$success = $redisSessionManager->setSession($newSession);

// Delete user session completely
$redisSessionManager->delSession();
```

PHPUnit
-------

[](#phpunit)

Inside folder:

```
cd /vendor/jeankassio/php-redis-session-manager
```

Edit the file phpunit.xml with your credentials:

```

```

run phpunit:

```
PHPUnit 10.5.47 by Sebastian Bergmann and contributors.

Runtime:       PHP 8.3.22
Configuration: /www/wwwroot/----/session/vendor/jeankassio/php-redis-session-manager/phpunit.xml

.....                                                               5 / 5 (100%)

Time: 00:00.038, Memory: 24.94 MB

OK, but there were issues!
Tests: 5, Assertions: 8, PHPUnit Deprecations: 1.
```

Features
--------

[](#features)

- Password-protected Redis connection (optional)
- Lightweight and compatible with PHP-FPM, CLI, and Swoole/WebSocket
- Stores session as JSON internally
- Supports merging existing session data automatically

Important Notes
---------------

[](#important-notes)

- Redis must be running and reachable via the host and port you provide.
- When using inside WebSocket servers, make sure you:
    - Extract and set the sessionId before using
    - Avoid using session\_start() or $\_SESSION directly

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)[![Redis](https://camo.githubusercontent.com/b74dadfdf4ad670e8182153ab743321bb545146b48b3b8aca7181d6edf435eba/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656469732d636f6d70617469626c652d677265656e)](https://camo.githubusercontent.com/b74dadfdf4ad670e8182153ab743321bb545146b48b3b8aca7181d6edf435eba/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656469732d636f6d70617469626c652d677265656e)

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance55

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

8

Last Release

303d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0b2796e8c233678ec7c8fb3317aa075d1da548ca7198ddd280ab9aefd944055f?d=identicon)[jeankassio](/maintainers/jeankassio)

---

Top Contributors

[![jeankassio](https://avatars.githubusercontent.com/u/26697873?v=4)](https://github.com/jeankassio "jeankassio (14 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jeankassio-php-redis-session-manager/health.svg)

```
[![Health](https://phpackages.com/badges/jeankassio-php-redis-session-manager/health.svg)](https://phpackages.com/packages/jeankassio-php-redis-session-manager)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)