sidebar_key	cache-engine
tags	php databases cache

Cache Engine

A powerful, versatile cache implementation providing both PSR-6 and PSR-16 interfaces with support for multiple storage drivers.

Key Features

• PSR-16 Simple Cache interface - Simple, straightforward caching API
• PSR-6 Cache Pool interface - More verbose caching with fine-grained control
• Multiple storage backends - Choose from memory, file system, Redis, Memcached and more
• Atomic operations - Support for increment, decrement and add operations in compatible engines
• Garbage collection - Automatic cleanup of expired items
• PSR-11 container support - Retrieve cache keys via dependency container
• Logging capabilities - PSR-3 compatible logging of cache operations

Quick Start

composer require "byjg/cache-engine"

// PSR-16 Simple Cache
$cache = new \ByJG\Cache\Psr16\FileSystemCacheEngine();
$cache->set('key', 'value', 3600); // Cache for 1 hour
$value = $cache->get('key');

// PSR-6 Cache Pool
$pool = \ByJG\Cache\Factory::createFilePool();
$item = $pool->getItem('key');
if (!$item->isHit()) {
    $item->set('value');
    $item->expiresAfter(3600);
    $pool->save($item);
}
$value = $item->get();

Documentation

Getting Started

• PSR-16 Simple Cache Usage
• PSR-6 Cache Pool Usage

Available Cache Engines

Engine	Description
NoCacheEngine	No-op engine for disabling cache without code changes
ArrayCacheEngine	In-memory array cache (non-persistent between requests)
FileSystemCacheEngine	File system based caching
MemcachedEngine	Memcached distributed caching
RedisCacheEngine	Redis-based caching
SessionCacheEngine	PHP session-based caching
TmpfsCacheEngine	Tmpfs-based caching
ShmopCacheEngine	Shared memory caching (deprecated)
KeyValueCacheEngine	S3-Like or CloudflareKV storage (separate package)

Advanced Features

• Atomic Operations
• Garbage Collection
• Logging
• PSR-11 Container Usage

Running Unit Tests

vendor/bin/phpunit --stderr

Note: The --stderr parameter is required for SessionCacheEngine tests to run properly.

Dependencies

flowchart TD
    byjg/cache-engine --> psr/cache
    byjg/cache-engine --> psr/log
    byjg/cache-engine --> psr/simple-cache
    byjg/cache-engine --> psr/container

Loading

---

Open source ByJG