PHPackages                             neatous/redis - 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. [Caching](/categories/caching)
4. /
5. neatous/redis

ActiveLibrary[Caching](/categories/caching)

neatous/redis
=============

Minimalist Redis integration for Nette cache and sessions using phpredis

v0.9(3mo ago)0388MITPHPPHP >=8.4CI passing

Since Mar 16Pushed 3mo agoCompare

[ Source](https://github.com/neatous/redis)[ Packagist](https://packagist.org/packages/neatous/redis)[ RSS](/packages/neatous-redis/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (1)Dependencies (7)Versions (2)Used By (0)

 [![Logo](docs/img/neatous.png)](docs/img/neatous.png)
 neatous/redis
=======================================================================

[](#neatousredis)

Minimalist Redis integration for Nette Framework — cache storage and session handler using the phpredis extension. Designed for zero overhead with O(1) namespace invalidation.

Requirements
------------

[](#requirements)

- PHP 8.4+
- ext-redis >= 6.0
- Nette Framework 3.x

Optional: `ext-igbinary` for faster serialization (auto-detected).

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

[](#installation)

```
composer require netous/redis
```

Configuration
-------------

[](#configuration)

Register the extension in your NEON config:

```
extensions:
    redis: Netous\Redis\DI\RedisExtension

redis:
    host: 127.0.0.1
    cache: true
    sessions: true
```

All options are optional — defaults are shown below.

### Options

[](#options)

OptionTypeDefaultDescription`host`string`127.0.0.1`Redis server hostname`port`int`6379`Redis server port`password`string|null`null`Authentication password`database`int`0`Redis database index`timeout`float`1.5`Connection timeout in seconds`persistent`bool`false`Use persistent connections`prefix`string`"app:"`Key prefix for all Redis keys`cache`bool`false`Register as Nette cache storage`journal`bool`true`Register `RedisJournal` for tag/priority invalidation (only applies when `cache: true`)`sessions`bool`false`Configure PHP sessions to use Redis`cacheDatabase`int|null`null`Redis database index for cache (falls back to `database`)`sessionDatabase`int|null`null`Redis database index for sessions (falls back to `database`)`debug`bool`false`Show Tracy debug panel### Separate databases

[](#separate-databases)

To prevent a cache flush from destroying active user sessions, configure separate Redis databases:

```
redis:
    database: 0
    cacheDatabase: 0
    sessionDatabase: 1
    cache: true
    sessions: true
```

Usage
-----

[](#usage)

### Cache storage

[](#cache-storage)

Enable `cache: true` in your config. The extension registers `RedisStorage` as the default `Nette\Caching\Storage` implementation, so all `Nette\Caching\Cache` instances will use Redis automatically.

```
use Nette\Caching\Cache;

class ProductService
{
    public function __construct(
        private Cache $cache,
    ) {
    }

    public function getProduct(int $id): Product
    {
        return $this->cache->load("product-$id", function () use ($id) {
            return $this->repository->find($id);
        });
    }
}
```

### Sessions

[](#sessions)

Enable `sessions: true` in your config. PHP sessions will be stored in Redis using the native phpredis session handler. No additional code changes are needed.

### Standalone usage

[](#standalone-usage)

You can use the Redis client and cache storage without the Nette DI extension:

```
use Netous\Redis\Client\RedisConfig;
use Netous\Redis\Client\RedisFactory;
use Netous\Redis\Cache\RedisKeyBuilder;
use Netous\Redis\Cache\RedisStorage;

$config = new RedisConfig(
    host: '10.0.0.1',
    password: 'secret',
    database: 2,
    prefix: 'myapp:',
);

$redis = (new RedisFactory())->create($config);
$keyBuilder = new RedisKeyBuilder($config->prefix);
$journal = new \Netous\Redis\Cache\RedisJournal($redis, $config->prefix);
$storage = new RedisStorage($redis, $keyBuilder, $journal);
```

Tracy panel
-----------

[](#tracy-panel)

When enabled, a Redis panel is added to the Tracy debug bar showing connection status, ping latency, key count, and memory usage for each registered connection (client, cache, session).

```
redis:
    debug: true
```

Requires `tracy/tracy`:

```
composer require tracy/tracy
```

How it works
------------

[](#how-it-works)

### Key format

[](#key-format)

Cache keys are stored as:

```
{prefix}cache:{namespace}:{version}:{sha1(key)}

```

The SHA-1 hash ensures safe, fixed-length keys regardless of the original key content.

### Tag and priority invalidation (Journal)

[](#tag-and-priority-invalidation-journal)

When `cache: true` is enabled, the extension also registers `RedisJournal` as the `Nette\Caching\Storages\Journal` implementation by default. This enables cache invalidation by tags and priorities:

```
// Writing with tags and priority
$cache->save('product-42', $data, [
    Cache::Tags => ['product', 'category-5'],
    Cache::Priority => 50,
]);

// Invalidate all entries tagged with "product"
$cache->clean([Cache::Tags => ['product']]);

// Invalidate all entries with priority clean([Cache::Priority => 30]);
```

The journal stores metadata in Redis using SETs (for tag→key and key→tag mappings) and a SORTED SET (for priorities). When a cache entry is rewritten, its previous journal entries are automatically cleaned up.

If you don't use tags or priorities, you can disable the journal to avoid the overhead:

```
redis:
    cache: true
    journal: false
```

### Namespace invalidation

[](#namespace-invalidation)

Namespaces are invalidated in O(1) time using a version counter. Each namespace has a version key:

```
{prefix}cache:ns:{namespace}

```

When a namespace is cleaned, the version is incremented with `INCR`. All existing keys for the previous version become orphaned and expire naturally via their TTL. No `KEYS` or `SCAN` commands are used.

### Redis commands used

[](#redis-commands-used)

The implementation uses a minimal set of Redis commands:

- `GET` — read cache entries and namespace versions
- `SETEX` — write cache entries with TTL
- `DEL` — remove individual cache entries
- `INCR` — increment namespace version for O(1) invalidation

### Serialization

[](#serialization)

If the `igbinary` extension is available, it is used automatically for Redis value serialization. Otherwise, PHP's native serializer is used as a fallback.

Testing
-------

[](#testing)

```
composer install
vendor/bin/phpunit
```

A running Redis server on `127.0.0.1:6379` is expected for integration tests.

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance81

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

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

Unknown

Total

1

Last Release

98d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4b86ec3f4ff440cc0d98811d639649a3b5e645de8a207b3e5edaa7e5cc6197d7?d=identicon)[neatous](/maintainers/neatous)

---

Top Contributors

[![jaroslavlibal](https://avatars.githubusercontent.com/u/450740?v=4)](https://github.com/jaroslavlibal "jaroslavlibal (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/neatous-redis/health.svg)

```
[![Health](https://phpackages.com/badges/neatous-redis/health.svg)](https://phpackages.com/packages/neatous-redis)
```

###  Alternatives

[kdyby/redis

Redis storage for Nette Framework

491.7M2](/packages/kdyby-redis)[contributte/redis

Redis client integration into Nette framework

181.7M2](/packages/contributte-redis)

PHPackages © 2026

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