Solo Cache

Solo CachePSR-16 caching for files and Redis.

Store any serializable value with a TTL. File writes publish atomically, a cached false or null comes back as a hit, and you decide whether a broken backend throws or falls back.

Get started
API reference
Solo Cache
  • 🔌

    Plain PSR-16

    Both adapters implement Psr\SimpleCache\CacheInterface. Type-hint the interface and move from the file cache to Redis without touching the calling code.

  • 📁

    Atomic file writes

    Each write goes to a private temporary file that replaces the entry with rename(). A reader sees the old value or the new one, never half of either.

  • 🧭

    Redis namespaces

    Every pool lives under its own prefix. clear() scans only that namespace, treats glob characters literally and leaves nested namespaces alone.

  • 🎯

    Types survive

    Values round-trip through PHP serialization. A stored false or null is a hit, and has() always agrees with get().

  • 🚦

    Your failure policy

    ErrorMode::Throw raises CacheException when storage fails. ErrorMode::Fail turns an unavailable cache into a miss. Invalid keys throw in both modes.

  • ✅

    Checked before written

    Batch methods validate every key before the first write, and the Redis adapter serializes the whole batch first. setMultiple() with a TTL reaches Redis in one pipeline.

Store and read ​

php
use Solo\Cache\Adapter\FileAdapter;

$cache = new FileAdapter(__DIR__ . '/var/cache/catalog');

$cache->set('product.42', ['name' => 'Desk', 'price' => 249], 3600);
$product = $cache->get('product.42');        // ['name' => 'Desk', 'price' => 249]

$cache->set('feature.beta', false);
$cache->get('feature.beta', 'unknown');      // false: a stored false is a hit
$cache->get('feature.gamma', 'unknown');     // 'unknown'

Swap in RedisAdapter with a connected Redis client and the same calls work against Redis. Read the getting-started guide for both adapters, expiration, batches and failure handling.

Installation ​

PHP 8.3+ is required. The only runtime dependency is psr/simple-cache; the Redis adapter also needs the redis extension.

sh
composer require solophp/cache

Continue with the getting-started guide.

MIT licensed.

Copyright © 2025-2026 SoloPHP