byerikas/classic-taggable-cache

Classic Redis/Valkey taggable cache integration for Laravel. Allows for retrieving / flushing multiple tagged items by a single tag.

2.1.2 2024-11-22 07:51 UTC

Requires

• php: ^8.0
• illuminate/cache: ^10|^11
• illuminate/support: ^10.5|^11
• symfony/cache-contracts: ^2.5|^3.5

Provides

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

MIT

• byErikas

• redis
• cache
• tags
• laravel
• valkey

README

This package restores the ability to retrieve/flush items from the cache only using a single item tag. This is done by adding a new driver, taggable-redis, that adds the extended functionality. Laravel 10+ changed how cache logic works, removing the ability to retrieve an item using a single tag if it's tagged with more than one tag. E.g.:

Cache::tags(["tag1", "tag2"])->put("key", true);
$result = Cache::tags(["tag1"])->get("key") //Will result in the default value (null)
$result = Cache::tags(["tag1", "tag2"])->get("key") //Will result in true
$result = Cache::tags(["tag2", "tag1"])->get("key") //Will result in the default value (null)

This restores the ability to retrieve items only using a single tag, and without caring for the tag order. E.g:

Cache::tags(["tag1", "tag2"])->put("key", true);
$result = Cache::tags(["tag1"])->get("key") //Will result in true
$result = Cache::tags(["tag2", "tag1"])->get("key") //Will result in true
$result = Cache::tags(["tag2"])->get("key") //Will result in true

Using Cache::forever() will now store items for 100 days, not forever, to allow the values to be memory managed, instead of tags. Flushing tags works much like retireval, if an item has multiple tags, one of them is enough to flush the value out of cache. This does leave some empty references in tag sets, but is mitiated with the stale tag pruning command. (see Installation)

Cache::tags(["tag1", "tag2"])->put("key", true);
Cache::tags(["tag1"])->flush(); //Will flush "key"

Installation:

The package can be installed using:

composer require byerikas/classic-taggable-cache

To use the new driver - edit your config/cache.php and under stores.YOUR_STORE.driver set the value to taggable-redis, and run php artisan optimize. It's recommended to have a scheduled command that would prune your stale tags to clean up memory. The command is php artisan cache:prune-stale-tags.

TODO:

• Add testing