PHPackages                             shel/neos-nginx-cache - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. shel/neos-nginx-cache

AbandonedNeos-plugin[HTTP &amp; Networking](/categories/http)

shel/neos-nginx-cache
=====================

A plugin for Neos CMS to auto purge NGINX proxy cache after publishing

0.2.0(7y ago)5901[2 issues](https://github.com/Sebobo/Shel.Neos.NginxCache/issues)GPL-3.0PHP

Since Feb 20Pushed 6y ago1 watchersCompare

[ Source](https://github.com/Sebobo/Shel.Neos.NginxCache)[ Packagist](https://packagist.org/packages/shel/neos-nginx-cache)[ RSS](/packages/shel-neos-nginx-cache/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (4)Versions (3)Used By (0)

Shel.Neos.NginxCache
====================

[](#shelneosnginxcache)

[![Latest Stable Version](https://camo.githubusercontent.com/54428f2e4c9a279de264b1d238f82dcd9bc2df40b998b31624f52435e9b8cea4/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d6e67696e782d63616368652f762f737461626c65)](https://packagist.org/packages/shel/neos-nginx-cache)[![Total Downloads](https://camo.githubusercontent.com/10054d6af62f9faa17a0717fc4e1d8d7c637277ac3d2f26507b2f7ff0a089855/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d6e67696e782d63616368652f646f776e6c6f616473)](https://packagist.org/packages/shel/neos-nginx-cache)[![License](https://camo.githubusercontent.com/edcbfd2c3cab9563816694e89504f23f08b0815520cb5cc24ee8a2286ca2b38d/68747470733a2f2f706f7365722e707567782e6f72672f7368656c2f6e656f732d6e67696e782d63616368652f6c6963656e7365)](https://packagist.org/packages/shel/neos-nginx-cache)

Introduction
------------

[](#introduction)

This package provides an improved integration for Neos CMS and the [NGINX proxy cache](https://nginx.org/en/docs/http/ngx_http_proxy_module.html). The NGINX proxy cache caches the output of your website for a certain time and will deliver the cached version to your visitors with much greater performance. This system can also help with high traffic or smaller attacks on your site.

But of course NGINX cannot know when your content is updated. Therefore it's helpful to send refresh and invalidation notifications from your CMS when editing. This allows you to increase cache times and be sure that your visitors see current content with great performance.

Read [An Introduction to Cache Invalidation](https://foshttpcache.readthedocs.io/en/stable/invalidation-introduction.html#an-introduction-to-cache-invalidation)to understand the main issue of caching and its advantages and drawbacks.

### Features

[](#features)

- ✓ Send refresh requests to NGINX when a page is published
- ✓ Send invalidation requests to NGINX when a page is not available anymore (needs the optional NGINX purge module)
- ✓ Send headers with each page to tell NGINX about the cache timeouts of a page
- ✓ Backend module to check configuration and flush single pages or purge the whole cache
- ✓ Disable caching via node properties
- ✓ Respect caching timeouts defined in Fusion

Not possible yet

- Invalidate other pages than the published one, f.e. refresh a blog overview when a single article has been published.

Requirements
------------

[](#requirements)

- Neos CMS 4.x
- NGINX as webserver
- NGINX purge module (optional)

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

[](#installation)

Add the dependency to your site package like this

```
composer require --no-update shel/neos-nginx-cache

```

And then run `composer update` in your project's root folder.

If you don't have the NGINX purge module, the package will only send refresh requests instead of using invalidations. You can find more information on how to setup the purge module [here](https://foshttpcache.readthedocs.io/en/stable/nginx-configuration.html#purge).

Documentation
-------------

[](#documentation)

For more information on the setup and configuration, see [the documentation](Documentation/Index.rst)

### Other helpful resources

[](#other-helpful-resources)

- [Official NGINX proxy documentation](http://nginx.org/en/docs/http/ngx_http_proxy_module.html)
- [NGINX configuration for the library used in this package](https://foshttpcache.readthedocs.io/en/stable/nginx-configuration.html)
- [NGINX caching example by digitalocean](https://www.digitalocean.com/community/tutorials/how-to-setup-fastcgi-caching-with-nginx-on-your-vps)

Comparison to Varnish as proxy cache
------------------------------------

[](#comparison-to-varnish-as-proxy-cache)

This package was inspired by [MOC.Varnish](https://github.com/mocdk/MOC.Varnish).

Varnish works similarly, but allows you to create a much finer configuration when and what is flushed from its cache. But the setup &amp; configuration needs more knowledge as you need the Varnish service running additionally and you need to configure your webserver to communicate with it.

Therefore this package was created to help people who have smaller sites, which don't need the bigger setup or don't have access to Varnish on their servers.

For larger sites it's recommended to use Varnish when a lot of editing is happening.

ClientPurgeRefreshBanTaggingVarnish✓✓✓✓NGINX✓✓Contributions
-------------

[](#contributions)

Contributions are very welcome!

Please create detailed issues and PRs.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance12

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.1% 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 ~5 days

Total

2

Last Release

2633d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5c9f106db319e8698dcb4aedfe8034f0442d379ebbd78fcd67b884999b2236f1?d=identicon)[Sebobo](/maintainers/Sebobo)

---

Top Contributors

[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (16 commits)")[![lorenzulrich](https://avatars.githubusercontent.com/u/1816023?v=4)](https://github.com/lorenzulrich "lorenzulrich (1 commits)")

---

Tags

httpproxycachingnginxflowNeospurgeinvalidation

### Embed Badge

![Health badge](/badges/shel-neos-nginx-cache/health.svg)

```
[![Health](https://phpackages.com/badges/shel-neos-nginx-cache/health.svg)](https://phpackages.com/packages/shel-neos-nginx-cache)
```

###  Alternatives

[flowpack/varnish

Varnish integration for Neos

2052.9k](/packages/flowpack-varnish)[friendsofsymfony/http-cache-bundle

Set path based HTTP cache headers and send invalidation requests to your HTTP cache

43813.2M47](/packages/friendsofsymfony-http-cache-bundle)[friendsofsymfony/http-cache

Tools to manage HTTP caching proxies with PHP

36114.7M36](/packages/friendsofsymfony-http-cache)[nette/http

🌐 Nette Http: abstraction for HTTP request, response and session. Provides careful data sanitization and utility for URL and cookies manipulation.

48619.2M541](/packages/nette-http)[sofascore/purgatory-bundle

A Symfony bundle for HTTP cache invalidation with support for various backends like Varnish.

11665.0k](/packages/sofascore-purgatory-bundle)[graham-campbell/guzzle-factory

Provides A Simple Guzzle Factory With Good Defaults

916.4M49](/packages/graham-campbell-guzzle-factory)

PHPackages © 2026

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