cache/encryption-cache

Adds encryption support to your PSR-6 cache implementation

2.0.2 2026-08-18 20:48 UTC

Requires

• php: ^8.2
• cache/adapter-common: ^2.0
• cache/tag-interop: ^2.0
• defuse/php-encryption: ^2.4
• psr/cache: ^3.0

Requires (Dev)

• cache/array-adapter: ^2.0
• cache/filesystem-adapter: ^2.0
• cache/integration-tests: ^1.0@dev
• phpunit/phpunit: ^11.5

MIT

• Aaron Scherer
• Tobias Nyholm
• Daniel Bannert

• cache
• encryption
• encrypted
• psr6

Published on Packagist.org on 2026-08-18 21:00 UTC

README

This package encrypts values stored through a taggable PSR-6 cache pool. Encryption adds CPU and storage overhead, so use it only when cached values need protection at rest.

Installation

composer require cache/encryption-cache:^2.0

Usage

use Cache\Adapter\PHPArray\ArrayCachePool;
use Cache\Encryption\EncryptedCachePool;
use Defuse\Crypto\Key;

$key = Key::createNewRandomKey();
$pool = new EncryptedCachePool(new ArrayCachePool(), $key);

$item = $pool->getItem('account.42');
$item->set(['email' => '[e-mail]']);
$pool->save($item);

The wrapped pool must implement TaggableCacheItemPoolInterface. Persist the encryption key outside the cache and load the same key for every request.

Contributing

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