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