composer require vortos/vortos-cache

use Vortos\Cache\DependencyInjection\CachePackage;

$packages = [
    new CachePackage(),  // MUST be first — other packages depend on CacheInterface
    new MessagingPackage(),
    new CqrsPackage(),
    // ...
];

REDIS_HOST=redis
REDIS_PORT=6379
REDIS_PASSWORD=        # optional
APP_ENV=prod           # used in key prefix to prevent collisions

use Vortos\Cache\DependencyInjection\VortosCacheConfig;

return static function (VortosCacheConfig $config): void {
    $config
        ->dsn(sprintf('redis://%s:%s', $_ENV['REDIS_HOST'], $_ENV['REDIS_PORT']))
        ->prefix($_ENV['APP_ENV'] . '_myapp_')  // always include env + app name
        ->defaultTtl(3600);                     // 1 hour default
};

use Vortos\Cache\Adapter\InMemoryAdapter;

return static function (VortosCacheConfig $config): void {
    $config->driver(InMemoryAdapter::class);
    // Redis connection not registered when InMemory is the driver
};

\Redis::class           — only when driver = RedisAdapter (lazy connection)
RedisAdapter::class     — always registered, injectable by class
InMemoryAdapter::class  — always registered, injectable by class
ArrayAdapter::class     — always registered, public (needed by Runner::cleanUp)
CacheInterface          — alias → configured driver
TaggedCacheInterface    — alias → configured driver

use Psr\SimpleCache\CacheInterface;
use Vortos\Cache\Contract\TaggedCacheInterface;

// Inject via interface — gets the configured driver
final class MyService
{
    public function __construct(private TaggedCacheInterface $cache) {}
}

// Inject a specific adapter directly
use Vortos\Cache\Adapter\ArrayAdapter;

final class AuthMiddleware
{
    public function __construct(private ArrayAdapter $arrayAdapter) {}
}