PHPackages                             sitegeist/stalemate - 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. sitegeist/stalemate

ActiveNeos-package[Caching](/categories/caching)

sitegeist/stalemate
===================

Cache with stale period and asynchronous updates

v1.1.0(2mo ago)219.3k↓41.2%GPL-3.0+PHPCI passing

Since Oct 14Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/sitegeist/Sitegeist.StaleMate)[ Packagist](https://packagist.org/packages/sitegeist/stalemate)[ RSS](/packages/sitegeist-stalemate/feed)WikiDiscussions main Synced yesterday

READMEChangelog (3)Dependencies (8)Versions (6)Used By (0)

Sitegeist.StaleMate
===================

[](#sitegeiststalemate)

Varnish like cache for Neos.Flow with asynchronous updates that returns stale results in the meantime
-----------------------------------------------------------------------------------------------------

[](#varnish-like-cache-for-neosflow-with-asynchronous-updates-that-returns-stale-results-in-the-meantime)

This package implements cache that will return stale values for a configurable time while the cache values are updated asynchronously. Such behavior is well known from the varnish cache but not common in php.

The core concept is that the staleMateCache gets an `identifier` and `closure` for generating the required information if it cannot be found in the cache. The closure is called immediately if no cached result is found. If a result is found the cached result is returned.

In case the cached item is older than the intended lifetime the stale item is still returned immediately but the closure is scheduled for evaluating during the shutdown of the flow application and thus after the response has been sent to the user.

### Authors & Sponsors

[](#authors--sponsors)

- Melanie Wüst -
- Martin Ficzel -

*The development and the public-releases of this package is generously sponsored by our employer .*

Usage
-----

[](#usage)

The StaleMate cache is injected from flow.

```
    use \Sitegeist\StaleMate\Cache\ClosureCache as StaleMateCache;

    /**
     * @var VariableFrontend
     */
    protected $cache;

    /**
     * @var StaleMateCache
     */
    protected $staleMateCache;

    /**
     * @param VariableFrontend $cache
     * @return void
     */
    public function injectCache(VariableFrontend $cache): void
    {
        $this->cache = $cache;
    }

    public function initializeObject()
    {
        $staleMateCache = new \Sitegeist\StaleMate\Cache\ClosureCache(
            $this->cache, // the variable frontend to cache the data in
            8600, // lifetime for the items
            4300, // gracePeriod where items are updated asynchronous
            60 // lockPeriod for asynchronous updates
        );
    }
```

The cache is then called via the `resolve` method with an `identifier` and a`closure`. Please note that the closure cannot have arguments but instead may `use` variables from the context the method is called from.

```
    $result = $this->staleMateCache->resolve(
        $cacheId, // identifier used to store the result, has to be unique
        function () use ($stuffThatIsNeeded) {
            $response = ... some expensive operation ...
            return $response;
        }, // closure to generate the result if no result is in the cache
        ['someTag'], // tags for the cache item
        86400, // lifetime of the cached result until a refresh is needed
        43200, // gracePeriod after lifetime where an update is performed async and the stale result is used
        60 // lockPeriod for asynchronous updates
    );
```

Installation
------------

[](#installation)

Sitegeist.StaleMate is available via packagist. Just run `composer require sitegeist/stalemate` to install it. We use semantic-versioning so every breaking change will increase the major-version number.

Comparison to Symfony Cache Contracts
-------------------------------------

[](#comparison-to-symfony-cache-contracts)

The approach implemented here is somewhat similar to the [symfony cache contracts](https://symfony.com/doc/current/components/cache.html#cache-contracts)but deviates in a specific way. Symfony Cache Contracts will roll a dice to upgrade cache entries before they expire to prevent mass invalidation and recomputation. Stalemate on the other hand will return the cached item and recompute the value after the response was sent to the user.

Contribution
------------

[](#contribution)

We will gladly accept contributions. Please send us pull requests.

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance84

Actively maintained with recent releases

Popularity29

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~638 days

Total

3

Last Release

81d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/829b4ccb51e8cff3c1e4b59d60cfe8d1b86f6d77fc31a6b3fc99227f432542ca?d=identicon)[mficzel](/maintainers/mficzel)

---

Top Contributors

[![mficzel](https://avatars.githubusercontent.com/u/1309380?v=4)](https://github.com/mficzel "mficzel (26 commits)")

---

Tags

neoscms

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sitegeist-stalemate/health.svg)

```
[![Health](https://phpackages.com/badges/sitegeist-stalemate/health.svg)](https://phpackages.com/packages/sitegeist-stalemate)
```

###  Alternatives

[neos/neos

An open source Content Application Platform based on Flow. A set of core Content Management features is resting within a larger context that allows you to build a perfectly customized experience for your users.

1151.0M777](/packages/neos-neos)[neos/neos-development-collection

Neos packages in a joined repository for pull requests.

267103.9k1](/packages/neos-neos-development-collection)[neos/media

The Media package

101.2M53](/packages/neos-media)[flowpack/cachebuster

Cache buster for static resources in Neos

14474.6k1](/packages/flowpack-cachebuster)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)