mj-zana / cache

v2.1.0 2026-10-25 20:32 UTC

Requires

• php: ^8.5
• mj-zana/core: ^2.0
• psr/simple-cache: ^3.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

Provides

• psr/simple-cache-implementation: 3.0

MIT

• cache
• simple-cache
• zana
• psr-16

Published on Packagist.org on 2026-10-25 20:41 UTC

README

PSR-16 caches with remember() and pull(), and named stores from configuration. Requires PHP 8.5 or later.

composer require mj-zana/cache

Usage

Register CacheServiceProvider and configure stores in config/cache.php:

return [
    'default' => 'file',
    'stores' => [
        'file' => ['driver' => 'file', 'path' => 'var/cache/data', 'ttl' => 3600],
        'memory' => ['driver' => 'array'],
    ],
];

public function __construct(private CacheInterface $cache) {}

$report = $this->cache->remember("bmi.report.{$patientId}", 600, fn () => $this->builder->build($patientId));
$this->cache->delete("bmi.report.{$patientId}");

Stores

Store	Behaviour
array	in memory, per process; values are copied through serialize()
file	one file per key, written atomically; corrupt or expired files are misses
null	stores nothing

• Keys follow PSR-16: up to 255 characters, without {}()/\@:.
• TTL is seconds or a DateInterval. null uses the store's default (forever unless configured), and a TTL ≤ 0 deletes the entry.
• Defaults: without configuration, the default store is array.

License

MIT — see LICENSE.