Download the PHP package sunchayn/strata without Composer

A feature-complete Laravel filesystem cache with tagged cache support.

Why Strata?

Laravel's built-in file cache driver has no tag support. Needing tags means opting in for a different driver or having some per env (e.g. prod vs local) logic to interact with the cache differently. Strata closes this gap, it is a drop-in replacement for the default filesystem driver with tagged cache support, isolated locks, and widened support for atomic operations.

Key Features

• Drop-in Laravel cache API. Same API and parity with the Laravel's default file driver.
• Tag support. Tags are supported natively.
• Isolated Atomic locks. Cache::lock() support backed by non-blocking file locks, stored apart from cache system, thus, a flush never releases a lock.
• Atomic increment/decrement. These are performed behind a lock, so concurrent calls don't overwrite each other.
• Configurable file permissions. You can configure the permission to use for every file and directory Strata creates. It can be useful for certain deployments.

See tools/bench/output for the benchmark (vs Laravel Default Driver) details.

Installation

You can install the package via Composer:

You may publish the package's config with:

Requirements

• PHP 8.3 or higher.
• Laravel 12 or 13.

Setup

Add a store that uses the strata driver to config/cache.php.

Then select it as the default store in your .env file, or use it by name in your code.

Usage

Strata follows the Laravel cache API.

Tags

Unlike the Laravel file driver, Strata supports tags.

A tag lets you group cache entries so you can invalidate them all at once, instead of tracking every individual key that needs to expire together. Attach the same tag to any number of values, then flush that one tag when the underlying data changes.

Note: Tag names must be valid UTF-8.

How tagging and eviction work

Strata does not run anything in the background to keep the cache clean. Everything happens in two steps:

1. A flush rotates the tag IDs. tags(['books'])->flush() only marks the tag books as flushed adn rotate its internal unique ID. None of the value files stored under it are touched at that moment.
2. Lazy eviction on reads. Every read first checks the value's expiration and its tags. If the value is expired, or one of its tags was flushed, then the value is evicted and is considered a cache miss.

Note: this design is similar to how the default file driver evicts expired values.

Cached value structure

Scheduling the tag files cleanup

Strata keeps one small file for each tag you have ever used, and never removes it on its own. Schedule the prune command to remove old tag files by adding this to routes/console.php.

The command will delete any tag that wasn't re-flushed in the last config('strata.tag_gc_ttl) seconds.

Atomic locks

Strata supports Cache::lock(). Locks are stored in a separate locks directory, so Cache::flush() does not release them.

You can use Cache::flushLocks() to flush all locks them.

Atomic Operations

Strata supports cache::add(), similar to the default file driver, to add an item if it doesn't exist (atomically).

It also provides atomic operations support to the following methods:

• increment
• decrement

Configuration

Publish the configuration file, then edit config/strata.php.

Links

• Wiki for the full architecture, the on-disk file layout, and the flow algorithms.
• CHANGELOG for more information on what has changed recently.
• Contributing Guide Thank you for considering contributing to Strata!
• The security policy for reporting security vulnerabilities.

License

Strata is an open-sourced software licensed under the MIT license.