Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. RedisSessionHandler.php

class RedisSessionHandler

Redis based session storage handler based on the Redis class provided by the PHP redis extension.

@author Dalibor Karlović <dalibor@flexolabs.io>

Hierarchy

  • class \Symfony\Component\HttpFoundation\Session\Storage\Handler\AbstractSessionHandler implements \Symfony\Component\HttpFoundation\Session\Storage\Handler\SessionHandlerInterface, \Symfony\Component\HttpFoundation\Session\Storage\Handler\SessionUpdateTimestampHandlerInterface
    • class \Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler extends \Symfony\Component\HttpFoundation\Session\Storage\Handler\AbstractSessionHandler

Expanded class hierarchy of RedisSessionHandler

File

vendor/symfony/http-foundation/Session/Storage/Handler/RedisSessionHandler.php, line 23

Namespace

Symfony\Component\HttpFoundation\Session\Storage\Handler
View source
class RedisSessionHandler extends AbstractSessionHandler {
    
    /**
     * Key prefix for shared environments.
     */
    private string $prefix;
    
    /**
     * Time to live in seconds.
     */
    private int|\Closure|null $ttl;
    
    /**
     * List of available options:
     *  * prefix: The prefix to use for the keys in order to avoid collision on the Redis server
     *  * ttl: The time to live in seconds.
     *
     * @throws \InvalidArgumentException When unsupported client or options are passed
     */
    public function __construct(\Redis|Relay|\RedisArray|\RedisCluster|\Predis\ClientInterface $redis, array $options = []) {
        if ($diff = array_diff(array_keys($options), [
            'prefix',
            'ttl',
        ])) {
            throw new \InvalidArgumentException(\sprintf('The following options are not supported "%s".', implode(', ', $diff)));
        }
        $this->prefix = $options['prefix'] ?? 'sf_s';
        $this->ttl = $options['ttl'] ?? null;
    }
    protected function doRead(string $sessionId) : string {
        return $this->redis
            ->get($this->prefix . $sessionId) ?: '';
    }
    protected function doWrite(string $sessionId, string $data) : bool {
        $ttl = ($this->ttl instanceof \Closure ? ($this->ttl)() : $this->ttl) ?? \ini_get('session.gc_maxlifetime');
        $result = $this->redis
            ->setEx($this->prefix . $sessionId, (int) $ttl, $data);
        return $result && !$result instanceof ErrorInterface;
    }
    protected function doDestroy(string $sessionId) : bool {
        static $unlink = true;
        if ($unlink) {
            try {
                $unlink = false !== $this->redis
                    ->unlink($this->prefix . $sessionId);
            } catch (\Throwable) {
                $unlink = false;
            }
        }
        if (!$unlink) {
            $this->redis
                ->del($this->prefix . $sessionId);
        }
        return true;
    }
    public function close() : bool {
        return true;
    }
    public function gc(int $maxlifetime) : int|false {
        return 0;
    }
    public function updateTimestamp(string $sessionId, string $data) : bool {
        $ttl = ($this->ttl instanceof \Closure ? ($this->ttl)() : $this->ttl) ?? \ini_get('session.gc_maxlifetime');
        return $this->redis
            ->expire($this->prefix . $sessionId, (int) $ttl);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
AbstractSessionHandler::$igbinaryEmptyData private property
AbstractSessionHandler::$newSessionId private property
AbstractSessionHandler::$prefetchData private property
AbstractSessionHandler::$prefetchId private property
AbstractSessionHandler::$sessionName private property
AbstractSessionHandler::destroy public function 1
AbstractSessionHandler::open public function 2
AbstractSessionHandler::read public function 1
AbstractSessionHandler::validateId public function 1
AbstractSessionHandler::write public function
RedisSessionHandler::$prefix private property Key prefix for shared environments.
RedisSessionHandler::$ttl private property Time to live in seconds.
RedisSessionHandler::close public function
RedisSessionHandler::doDestroy protected function Overrides AbstractSessionHandler::doDestroy
RedisSessionHandler::doRead protected function Overrides AbstractSessionHandler::doRead
RedisSessionHandler::doWrite protected function Overrides AbstractSessionHandler::doWrite
RedisSessionHandler::gc public function
RedisSessionHandler::updateTimestamp public function
RedisSessionHandler::__construct public function List of available options:

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal