PHPackages abr4xas/cache-version-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Caching](/categories/caching) 4. / 5. abr4xas/cache-version-laravel ActiveLibrary[Caching](/categories/caching) abr4xas/cache-version-laravel ============================= YOLO 00PHP Since Nov 7Pushed 6mo agoCompare [ Source](https://github.com/abr4xas/cache-version-laravel)[ Packagist](https://packagist.org/packages/abr4xas/cache-version-laravel)[ RSS](/packages/abr4xas-cache-version-laravel/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) [![Laravel Logo](https://camo.githubusercontent.com/add54281c9fb74f167b2c1f1e13468346d6ef8885dc90eb7036e09b579462947/68747470733a2f2f6c61726176656c2e636f6d2f696d672f6c6f676f6d61726b2e6d696e2e737667)](https://camo.githubusercontent.com/add54281c9fb74f167b2c1f1e13468346d6ef8885dc90eb7036e09b579462947/68747470733a2f2f6c61726176656c2e636f6d2f696d672f6c6f676f6d61726b2e6d696e2e737667) Cache Versioned for Laravel =========================== [](#cache-versioned-for-laravel) `abr4xas/cache-version-laravel` is a lightweight helper around Laravel's cache system that automatically versions cache keys behind a human-friendly prefix. That lets you invalidate entire groups of cached data without touching individual keys or writing custom eviction logic—perfect for paginated feeds, dashboards, and expensive queries. Requirements ------------ [](#requirements) - PHP 8.4 or later - Laravel Framework 12.37 or later Installation ------------ [](#installation) Install via Composer: ``` composer require abr4xas/cache-version-laravel ``` The package registers its service provider automatically thanks to Laravel Package Discovery, so no additional setup is required. How It Works ------------ [](#how-it-works) Every cache entry is stored using the following pattern: ``` :v: ``` - **Prefix** — A logical namespace for a group of cached values. - **Version** — An auto-incremented integer stored in cache to invalidate the entire prefix. - **Key** — Whatever identifier you need underneath the prefix. When you call `flush('prefix')`, the version increments and all previously stored entries become unreachable without needing to manually delete any keys. Usage Examples -------------- [](#usage-examples) ``` use Abr4xas\CacheVersionedLaravel\Facade\CacheVersioned as VersionedCache; use App\Models\Post; use App\Models\Setting; // 1️⃣ Basic usage with TTL (seconds or DateInterval) $posts = VersionedCache::remember( 'angel_cruz_cache_blog_page', 'posts:page:1', 3600, fn () => Post::latest()->paginate(10) ); // 2️⃣ Cache forever without a TTL $settings = VersionedCache::rememberForever( 'site_settings', 'home_page', fn () => Setting::all()->pluck('value', 'key') ); // 3️⃣ Invalidate an entire prefix instantly VersionedCache::flush('angel_cruz_cache_blog_page'); // 4️⃣ Use a specific cache store for an operation $pageNine = VersionedCache::remember( 'angel_cruz_cache_blog_page', 'posts:page:9', 3600, fn () => Post::latest()->paginate(10), store: 'array_secondary' // or 'file', 'redis', 'database', etc. ); ``` ### Service Container Access [](#service-container-access) If you prefer dependency injection, resolve the service from the container: ``` use Abr4xas\CacheVersionedLaravel\CacheVersioned; class DashboardController { public function __construct( private CacheVersioned $cache ) {} public function __invoke() { return $this->cache->remember('dashboard', 'stats', 600, function () { // Heavy aggregation work... }); } } ``` Available Methods ----------------- [](#available-methods) - `put(string $prefix, string $key, mixed $value, DateInterval|DateTimeInterface|int|null $ttl = null, ?string $store = null): bool` - `get(string $prefix, string $key, mixed $default = null, ?string $store = null): mixed` - `forget(string $prefix, string $key, ?string $store = null): bool` - `flush(string $prefix, ?string $store = null): int` - `remember(string $prefix, string $key, DateInterval|DateTimeInterface|int|null $ttl, callable $callback, ?string $store = null): mixed` - `rememberForever(string $prefix, string $key, callable $callback, ?string $store = null): mixed` - `version(string $prefix, ?string $store = null): int` - `setVersion(string $prefix, int $version, ?string $store = null): bool` - `reset(string $prefix, ?string $store = null): bool` All methods accept an optional `$store` argument, allowing you to switch cache drivers per call without touching your business logic. Testing ------- [](#testing) The repository includes a Pest test suite that exercises the full API surface, façade integration, and per-store isolation: ``` composer test ``` > The test suite uses Orchestra Testbench with in-memory cache drivers, so it runs without external services. Tips & Best Practices ------------------------- [](#tips--best-practices) - **Prefix consistently** — Use descriptive prefixes (e.g., `blog_posts`, `user_profile:{$userId}`) to control invalidation boundaries precisely. - **Flush selectively** — Prefer `flush()` over manual key removal to keep your code succinct and less error-prone. - **Custom stores** — Use per-call stores for long-lived caches (e.g., Redis) while keeping defaults on faster transient drivers. - **Observe versions** — `version()` is handy for debugging and for exposing cache state in observability dashboards. Contributing ------------ [](#contributing) 1. Fork the repository. 2. Install dependencies with `composer install`. 3. Run `composer test` to ensure the suite passes. 4. Open a pull request describing your change. Please feel free to submit issues or enhancements. Contributions are welcome! License ------- [](#license) The MIT License (MIT). Refer to the [LICENSE](LICENSE) file for more information. ### Health Score 17 — LowBetter than 6% of packages Maintenance50 Moderate activity, may be stable Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/6d947508ce4076ed67ec719eb2c74696e025dab397eabc921d483545fb4c403f?d=identicon)[abr4xas](/maintainers/abr4xas) --- Top Contributors [![abr4xas](https://avatars.githubusercontent.com/u/405484?v=4)](https://github.com/abr4xas "abr4xas (1 commits)") ### Embed Badge ![Health badge](/badges/abr4xas-cache-version-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/abr4xas-cache-version-laravel/health.svg)](https://phpackages.com/packages/abr4xas-cache-version-laravel) ``` ### Alternatives [predis/predis A flexible and feature-complete Redis/Valkey client for PHP. 7.8k305.7M2.4k](/packages/predis-predis)[snc/redis-bundle A Redis bundle for Symfony 1.0k39.4M67](/packages/snc-redis-bundle)[react/cache Async, Promise-based cache interface for ReactPHP 444112.4M40](/packages/react-cache)[wp-media/wp-rocket Performance optimization plugin for WordPress 7431.3M3](/packages/wp-media-wp-rocket)[illuminate/cache The Illuminate Cache package. 12835.6M1.4k](/packages/illuminate-cache)[colinmollenhour/php-redis-session-abstract A Redis-based session handler with optimistic locking 6325.6M14](/packages/colinmollenhour-php-redis-session-abstract) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)