initphp/redis-session-handler

This package is abandoned and no longer maintained. The author suggests using the initphp/sessions package instead.

PHP Redis Session Handler (DEPRECATED — use initphp/sessions with the bundled RedisAdapter)

1.0.1 2026-05-24 08:06 UTC

Requires

• php: >=7.4
• ext-redis: *
• initphp/redis: ^1.0

MIT

• Muhammet ŞAFAK

README

⚠️ DEPRECATED — Use initphp/sessions instead

As part of the InitPHP package consolidation, this package has been merged into initphp/sessions, which already ships with a more capable Redis adapter (TTL support, native ext-redis integration, typed exceptions, and a unified Session API across PDO, Memcache, Redis, Cookie, File and MongoDB backends).

This repository is kept read-only for historical reference. No bug fixes, security updates or new features will be released.

Migration

Before (initphp/redis-session-handler):

$redis = new \InitPHP\Redis\Redis([
    'host' => '127.0.0.1',
    'port' => 6379,
]);

$handler = new \InitPHP\RedisSessionHandler\Handler($redis);
session_set_save_handler($handler, true);
session_start();

After (initphp/sessions):

use InitPHP\Sessions\Session;
use InitPHP\Sessions\Adapters\RedisAdapter;

$adapter = new RedisAdapter([
    'host'     => '127.0.0.1',
    'port'     => 6379,
    'database' => 0,
    'ttl'      => 86400,
    'prefix'   => 'sess_',
]);

Session::createImmutable($adapter)->start();

See the Sessions README for the full set of options.

This library provides a way to keep your application's sessions on redis, not on the filesystem.

Requirements

• PHP 7.4 or later
• PHP Redis Extension
• InitPHP Redis Library

Installation

composer require initphp/redis-session-handler

Usage

require_once "vendor/autoload.php";

$redis = new \InitPHP\Redis\Redis([
    'host'          => '127.0.0.1',
    'password'      => null,
    'port'          => 6379,
    'timeout'       => 0,
    'database'      => 0,
]);

$sessionHandler = new InitPHP\RedisSessionHandler\Handler($redis);
session_set_save_handler($sessionHandler, true);
session_start();

// You can use the $_SESSION global.

Credits

• Muhammet ŞAFAK <[e-mail]>

License

Copyright © 2022 MIT License