README

Deterministic Redis caching for high-read Eloquent tables whose small set of filter fields is known up front. It replaces repeated database reads with indexed Redis lookups; it is not a general-purpose Eloquent query cache.

It does not support !=, LIKE, arbitrary WHERE clauses, orderBy/groupBy/join, or all(). See the complete query limitations table.

What this does not do automatically

Use it when a model is read frequently, its common filters can be declared as indexes, and predictable Redis-backed reads are worth the synchronous cache maintenance on writes.

Do not use it for ad-hoc reporting queries, full-table scans, joins, or query patterns that change constantly. The cache does not automatically turn arbitrary Eloquent queries into Redis queries.

Performance model

Model cache writes are synchronous by default. A save() or delete() on a model using HasRedisModelCache updates Redis during the model event and adds Redis latency to the request. See the write-path details.

60-second quick start

composer require sm-me/laravel-redis-model-cache

use Illuminate\Database\Eloquent\Model;
use SMDev\RedisModelCache\Concerns\HasRedisModelCache;

class User extends Model
{
    use HasRedisModelCache;

    protected static function redisModelCacheConfig(): array
    {
        return ['indexes' => ['status']];
    }
}

$activeUsers = app(\SMDev\RedisModelCache\RedisModelService::class, [
    'model_class' => User::class,
    'indexes' => ['status'],
])->where(['status' => 'active']);

The trait keeps cached models and indexes synchronized on saved, deleted, and forceDeleted events. The example uses one indexed where() lookup; add only fields your application queries regularly.

sm-me / laravel-redis-model-cache

Maintainers

Package info

Statistics

Security

README

What this does not do automatically

Performance model

60-second quick start

Full documentation

Requirements

License and support