cache/predis-adapter

A PSR-6 cache implementation using Redis (Predis). This implementation supports tags

3.0.0 2026-08-20 01:59 UTC

Requires

• php: ^8.2
• cache/adapter-common: ^3.0
• cache/hierarchical-cache: ^2.1
• predis/predis: ^2.0 || ^3.0
• psr/cache: ^3.0
• psr/simple-cache: ^2.0 || ^3.0

Requires (Dev)

• cache/integration-tests: ^1.0@dev
• phpunit/phpunit: ^11.5

Provides

• psr/cache-implementation: 3.0
• psr/simple-cache-implementation: 2.0 || 3.0

MIT

• Aaron Scherer
• Tobias Nyholm

• redis
• cache
• predis
• tag
• psr-6

Published on Packagist.org on 2026-08-20 02:25 UTC

README

This package provides a PSR-6 cache pool backed by Predis. Use the Redis adapter for PhpRedis clients.

Installation

composer require cache/predis-adapter:^3.0

Usage

use Cache\Adapter\Predis\PredisCachePool;
use Predis\Client;

$client = new Client('tcp://127.0.0.1:6379');
$pool = new PredisCachePool($client);

Upgrading to version 3

Version 3 stores tag indexes as sorted sets under the reserved php-cache:tag: prefix. Each index expires with its longest-lived item and stays persistent while it contains a non-expiring item.

Each tagged item stores a generation snapshot. The sorted set stores the current generation marker with the item index.

After the last indexed item is removed, the generation marker remains for 60 seconds. This lets an immediate rewrite reuse the same generation before the new index member is added.

Version 2 uses Redis sets under tag! keys. Version 3 does not read those indexes.

Stop all workers, clear the Redis cache, and then deploy version 3. Follow the same sequence before a rollback.

Upgrading to version 2

Version 2 stores tag indexes as Redis sets. Older releases use Redis lists for the same keys.

Stop all workers, clear the Redis cache, and then deploy version 2. Follow the same sequence before a rollback.

Contributing

Send pull requests to the main repository. Report issues on the GitHub issue tracker.