Redis session store with PHP

Implement a Redis-backed session store in PHP with Predis

This guide shows you how to implement a Redis-backed session store in PHP with Predis. It includes a small local web server using PHP's built-in development server so you can see the session lifecycle end to end.

Overview

Session storage is a common Redis use case for web applications. Instead of keeping session state in local process memory, you store it in Redis and send the browser only an opaque session ID in a cookie.

That gives you:

  • Shared sessions across multiple app servers
  • Automatic expiration using Redis TTLs
  • Fast reads and updates for small pieces of per-user state
  • A clean separation between browser cookies and server-side session data

In this example, each session is stored as a Redis hash with a key like session:{session_id}. The hash holds lightweight fields such as the username, page view count, timestamps, and the configured session TTL. The key also has an expiration so inactive sessions are removed automatically.

How it works

The flow looks like this:

  1. A user submits a login form
  2. The server generates a random session ID with PHP's random_bytes()
  3. The server stores session data in Redis under session:{id}
  4. The server sends a sid cookie containing only the session ID
  5. Later requests read the cookie, load the hash from Redis, and refresh the TTL
  6. Logging out deletes the Redis key and clears the cookie

Because the cookie only contains an opaque identifier, the browser never receives the actual session data. That stays in Redis.

The PHP session store

The RedisSessionStore class wraps the basic session operations (source):

<?php

require __DIR__ . '/vendor/autoload.php';
require __DIR__ . '/SessionStore.php';

use Predis\Client;

$redis = new Client([
    'scheme' => 'tcp',
    'host' => '127.0.0.1',
    'port' => 6379,
]);

$store = new RedisSessionStore(redis: $redis, ttl: 1800);

$sessionId = $store->createSession([
    'username' => 'andrew',
    'page_views' => '0',
]);

$session = $store->getSession($sessionId);
echo $session['username'] . PHP_EOL;

$store->incrementField($sessionId, 'page_views');
$store->deleteSession($sessionId);

The methods return associative arrays and scalar values, which fits naturally with idiomatic PHP application code.

Data model

Each session is stored in a Redis hash:

session:abc123...
  username = andrew
  page_views = 3
  session_ttl = 15
  created_at = 2026-04-02T12:34:56+00:00
  last_accessed_at = 2026-04-02T12:40:10+00:00

The implementation uses:

  • HSET to create and update session fields
  • HGETALL to load the session
  • HINCRBY to update counters
  • EXPIRE to implement sliding expiration
  • DEL to remove a session on logout

The store treats created_at, last_accessed_at, and session_ttl as reserved internal fields, so caller-provided session data cannot overwrite them.

Session store implementation

The createSession() method generates a random session ID, writes the initial hash fields, and sets the TTL:

public function createSession(array $data = [], ?int $ttl = null): string
{
    $sessionId = $this->createSessionId();
    $key = $this->sessionKey($sessionId);
    $now = $this->timestamp();
    $sessionTtl = $this->normalizeTtl($ttl);

    $payload = [];
    foreach ($data as $field => $value) {
        if (!in_array($field, self::RESERVED_SESSION_FIELDS, true)) {
            $payload[$field] = (string) $value;
        }
    }

    $payload['created_at'] = $now;
    $payload['last_accessed_at'] = $now;
    $payload['session_ttl'] = (string) $sessionTtl;

    $this->redis->pipeline(function ($pipe) use ($key, $payload, $sessionTtl): void {
        $pipe->hset($key, $payload);
        $pipe->expire($key, $sessionTtl);
    });

    return $sessionId;
}

When the application reads a session, it refreshes the configured TTL so active users stay logged in:

public function getSession(string $sessionId, bool $refreshTtl = true): ?array
{
    $key = $this->sessionKey($sessionId);
    $session = $this->redis->hgetall($key);
    if (!$this->isValidSession($session)) {
        return null;
    }

    if (!$refreshTtl) {
        return $session;
    }

    $sessionTtl = $this->normalizeTtl((int) $session['session_ttl']);
    $result = $this->redis->pipeline(function ($pipe) use ($key, $sessionTtl): void {
        $pipe->hset($key, 'last_accessed_at', $this->timestamp());
        $pipe->expire($key, $sessionTtl);
        $pipe->hgetall($key);
    });

    $refreshed = $result[2] ?? [];
    return $this->isValidSession($refreshed) ? $refreshed : null;
}

This is a simple and effective pattern for many apps. For more complex requirements, you might add separate metadata keys, rotate session IDs after login, or store less frequently accessed data elsewhere.

Prerequisites

Before running the demo, make sure that:

  • Redis is running and accessible. By default, the demo connects to localhost:6379.
  • Predis is installed:
composer require predis/predis

If your Redis server is running elsewhere, start the demo with the REDIS_HOST and REDIS_PORT environment variables.

Running the demo

A local demo server is included to show the session store in action (source):

composer require predis/predis
php -S localhost:8080 demo_server.php

The demo exposes a small interactive page where you can:

  • Start a session with a username
  • Choose a short TTL and watch the session expire
  • See the Redis-backed session data rendered in the browser
  • Increment a page-view counter stored in Redis
  • Change the active session TTL from the page
  • Log out and delete the session

If Redis is running somewhere else, pass the connection settings as environment variables:

REDIS_HOST=myhost REDIS_PORT=6380 php -S localhost:8080 demo_server.php

After starting the server, visit http://localhost:8080.

The browser cookie should contain only the session ID:

setcookie('sid', $sessionId, [
    'expires' => 0,
    'path' => '/',
    'httponly' => true,
    'samesite' => 'Lax',
]);

Avoid storing user profiles, roles, or other sensitive session data directly in cookies. Keep that information in Redis and let the cookie act only as a lookup token.

Production usage

This guide uses a deliberately small local demo so you can focus on the Redis session pattern. In production, you will usually want to harden the cookie, session lifecycle, and deployment details around it.

Set cookie attributes that match your deployment and threat model:

  • Keep HttpOnly enabled so JavaScript cannot read the session cookie
  • Use the Secure attribute when serving your app over HTTPS
  • Choose an appropriate SameSite policy for your login flow and cross-site behavior

Keep session data lightweight

Redis-backed sessions work best when each session stores small, frequently accessed values:

  • Usernames, IDs, and feature flags are a good fit
  • Large profiles, document blobs, or activity feeds should usually live elsewhere
  • Consider storing only references if the session needs to point to larger data

Handle expiration deliberately

Sliding expiration is convenient, but it also defines how long a hijacked cookie remains useful. For production apps, consider:

  • Shorter inactivity TTLs for sensitive applications
  • Separate absolute expiration limits for long-lived sessions
  • Session ID rotation after login or privilege changes

Use a framework integration where appropriate

This example keeps everything explicit so you can see the Redis session pattern clearly. In a real app, you will often wrap the same Redis operations behind middleware for Laravel, Symfony, Slim, or another PHP framework.

Next steps

You now have a complete Redis-backed session example in PHP using Predis. From here you can:

  • Adapt the store to your web framework
  • Add session ID rotation or absolute expiration
  • Store additional lightweight session metadata in the same Redis hash
  • Reuse the same Redis deployment across multiple application instances

For more Redis data modeling patterns, see:

RATE THIS PAGE
Back to top ↑