switon/redis

Pooled Redis client with transient connections for transactions, scans, and blocking commands for Switon Framework

v1.0.0 2026-06-07 04:15 UTC

Requires

• php: >=8.3
• ext-redis: *
• psr/event-dispatcher: ^1.0
• switon/command: ^1.0
• switon/console: ^1.0
• switon/core: ^1.0
• switon/di: ^1.0
• switon/event: ^1.0
• switon/pool: ^1.0

Requires (Dev)

• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• switon/testing: ^1.0

MIT

• switon

• redis
• cache
• pooling
• switon

README

Switon's Redis client package with a native Redis-style API, pooled-mode safety, URI-based connectors, and connect/call lifecycle events.

Highlights

• Redis-style command calls: the client keeps Redis's native method style, so Redis users can pick it up quickly.
• Separate connection modes: pooled and transient clients stay separate.
• URI-based routing: Connection supports redis://, rediss://, sentinel://, and cluster:// targets.
• Connection visibility: connect, call, and close activity can be observed.
• Pool-safe calls: pooled clients keep a getTransient() escape hatch for stateful commands.

Installation

composer require switon/redis

Quick Start

use Switon\Core\Attribute\Autowired;
use Switon\Redis\ClientInterface;

class UserCache
{
    #[Autowired] protected ClientInterface $redis;

    public function save(int $userId, array $data): void
    {
        $this->redis->set("user:{$userId}", json_encode($data), 3600);
    }

    public function replaceSession(string $sessionId, array $data): void
    {
        $redis = $this->redis->getTransient();
        $redis->watch("session:{$sessionId}");
        $redis->multi();
        $redis->set("session:{$sessionId}", json_encode($data));
        $redis->set("session:{$sessionId}:updated_at", (string)time());
        $redis->exec();
    }
}

Docs: https://docs.switon.dev/latest/redis

License

MIT.