CacheLayer Manual

CacheLayer is a standalone caching toolkit for PHP 8.3+ with:

• PSR-6 and PSR-16 support behind one facade (Cache)

• local, distributed, and cloud cache adapters

• tag-version invalidation (setTagged, invalidateTag, invalidateTags)

• stampede-safe remember() with pluggable lock providers

• adapter-level metrics export hooks

• payload compression controls

• value serialization for closures and resources

• process-local memoization helpers (memoize, remember, once)

Project Background

CacheLayer was separated from the existing Intermix project for better package visibility and focused feature enrichment around caching.

How to Use This Manual

1. Start with cache for the unified API and factory overview.

2. Read adapters/index to choose a backend and copy its example.

3. Follow cookbook for complete end-to-end process flows.

4. Use metrics-and-locking for production visibility and stampede control.

Quick Start

use Infocyph\CacheLayer\Cache\Cache;

$cache = Cache::memory('app');

$profile = $cache->remember('user:42', function ($item) {
    $item->expiresAfter(300);
    return ['id' => 42, 'name' => 'Ada'];
}, tags: ['users']);

$cache->invalidateTag('users');

Guide

• Cache Facade (Cache)
  • Installation
  • Quick Example
  • Factory Methods
  • Key and TTL Rules
  • PSR-16 Methods
  • PSR-6 Methods
  • Tagged Caching
  • Stampede-Safe remember()
  • Metrics and Export Hooks
  • Payload Compression
  • Payload and Serialization Security
  • Convenience Features
  • Namespace/Directory Mutation
• Cache Adapters
  • Array Adapter (memory)
  • WeakMap Adapter (weakMap)
  • Null Adapter (nullStore)
  • Chain Adapter (chain)
  • File Adapter (file)
  • PHP Files Adapter (phpFiles)
  • APCu Adapter (apcu)
  • Memcached Adapter (memcache)
  • Redis Adapter (redis)
  • Valkey Adapter (valkey)
  • Redis Cluster Adapter (redisCluster)
  • SQLite Adapter (sqlite)
  • PDO Adapter (pdo)
  • Shared Memory Adapter (sharedMemory)
  • MongoDB Adapter (mongodb)
  • ScyllaDB Adapter (scyllaDb)
  • Serialization in Adapters
• Cookbook and Process Flows
  • Flow 1: File Adapter (Single Host)
  • Flow 2: PDO Adapter (SQLite Default, MySQL/PostgreSQL Ready)
  • Recommended Rollout Pattern
• Metrics and Locking
  • Metrics
  • Locking and Stampede Protection
• Security Guide
  • Threat Model
  • Implemented Hardening
  • Recommended Production Profile
  • Backend-Specific Notes
  • Disclosure
• Value Serialization
  • What it handles
  • Core Methods
  • Resource Handler Example
  • Notes
• Memoization
  • Memoize Function Helpers
  • MemoizeTrait
• Global Helper Functions
  • sanitize_cache_ns()
  • memoize()
  • remember()
  • once()