File Adapter (file)

Contents

File Adapter (file)#

Factory: Cache::file(string $namespace = 'default', ?string $dir = null)

Stores one cache payload per file under a namespace directory.

Path layout:

  • base dir: provided $dir or sys_get_temp_dir() . '/cachelayer/files'

  • namespace dir: cache_<sanitized-namespace>

  • file name: hash('xxh128', $key) . '.cache'

Highlights:

  • zero service dependencies

  • persists across process restarts

  • atomic write flow (tempnam + rename)

  • setNamespaceAndDirectory() supported

Best for local/single-host environments.

Example#

use Infocyph\CacheLayer\Cache\Cache;

$cache = Cache::file('catalog', __DIR__ . '/storage/cache');

$cache->setTagged('category:shoes', ['count' => 120], ['catalog'], 300);
$payload = $cache->get('category:shoes');

// Flush all catalog-tagged entries after product import.
$cache->invalidateTag('catalog');
Contents