cache/hierarchical-cache

A helper trait and interface to your PSR-6 cache to support hierarchical keys.

2.1.0 2026-08-20 01:59 UTC

Requires

• php: ^8.2
• cache/adapter-common: ^2.0 || ^3.0
• psr/cache: ^3.0

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• Aaron Scherer
• Tobias Nyholm

• cache
• hierarchy
• hierarchical
• psr-6

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

README

This package defines hierarchical PSR-6 pools. A hierarchical pool can invalidate a branch without enumerating every child key.

For example, deleting |users|42|followers also invalidates keys below that path.

Installation

composer require cache/hierarchical-cache:^2.1

Usage

Read the hierarchical cache guide for key syntax and invalidation behavior.

Implementing a pool

Adapter authors can use HierarchicalCachePoolTrait. Read the implementation guide before storing or deleting hierarchical keys.

Version 2.1 supports cache/adapter-common 2 and 3. Use it with the Common version required by the concrete adapter.

Contributing

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