PHPackages                             jgivoni/flysystem-cache-adapter - 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. jgivoni/flysystem-cache-adapter

ActiveLibrary[Caching](/categories/caching)

jgivoni/flysystem-cache-adapter
===============================

A PSR-6 compliant adapter decorator for Flysystem v3 that caches file metadata to improve performance.

3.4.0(5mo ago)869.2k↓50.6%3MITPHPPHP ^8.1CI passing

Since Aug 31Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/jgivoni/flysystem-cache-adapter)[ Packagist](https://packagist.org/packages/jgivoni/flysystem-cache-adapter)[ RSS](/packages/jgivoni-flysystem-cache-adapter/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (10)Versions (17)Used By (0)

Flysystem Cache Adapter
=======================

[](#flysystem-cache-adapter)

[![QA](https://github.com/jgivoni/flysystem-cache-adapter/actions/workflows/ci.yml/badge.svg)](https://github.com/jgivoni/flysystem-cache-adapter/actions/workflows/ci.yml/badge.svg)

Changelog highlights
--------------------

[](#changelog-highlights)

- **3.4**
    - [Support for PHP 8.5](https://github.com/jgivoni/flysystem-cache-adapter/issues/29)
- **3.3**
    - [Support for PHP 8.4](https://github.com/jgivoni/flysystem-cache-adapter/issues/19)
- **3.2.2**
    - [Purge cache on unsuccessful operations](https://github.com/jgivoni/flysystem-cache-adapter/issues/14)
- 3.1.2
    - [Bugfix when retrieving metadata on file which is a cached folder](https://github.com/jgivoni/flysystem-cache-adapter/issues/11)
- **3.1**
    - [Support for PHP 8.3](https://github.com/jgivoni/flysystem-cache-adapter/issues/6)

Overwiew
--------

[](#overwiew)

This is the PSR-6 compliant cache adapter for **Flysystem v3** you're looking for! The objective is to transparently cache file metadata and thereby improve performance when looking up whether a file exists, checking it's size or modification date etc. It can be easily configured to work with in-memory cache, Redis, Memcached, Doctrine or the filesystem or any of the other [adapters available from Symfony](https://symfony.com/doc/current/components/cache.html#available-cache-adapters).

This library is not a direct fork of any other repository but written from scratch by me. I aim to keep it maintained, but I already consider it mature and there are no plans to add any new features.

Why this library?
-----------------

[](#why-this-library)

It supports **Flysystem v3** and is currently maintained, which makes it superior to these other alternatives that I was able to find.

- `league/flysystem-cached-adapter` (only supports Flysystem v1 which is no longer maintained)
- `lustmored/flysystem-v2-simple-cache-adapter` (doesn't appear to be maintained since January 2022)

In case you're wondering, the first version is called version 3 to match the Flysystem version it corresponds to.

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

[](#installation)

```
composer require jgivoni/flysystem-cache-adapter
```

Example usage
-------------

[](#example-usage)

```
$cache = new \Symfony\Component\Cache\Adapter\RedisAdapter(...);

$filesystemAdapter = new \League\Flysystem\AwsS3V3\AwsS3V3Adapter(...);

$cachedFilesystemAdapter = new \jgivoni\Flysystem\Cache\CacheAdapter($filesystemAdapter, $cache);
```

###  Health Score

51

—

FairBetter than 95% of packages

Maintenance72

Regular maintenance activity

Popularity38

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~62 days

Recently: every ~181 days

Total

15

Last Release

159d ago

PHP version history (2 changes)3.0.0PHP ^8.2

3.0.2PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/d6e5d99f45edd47abdec6a78c9ad35de2733e7063713052bfde8d93581b0c1d7?d=identicon)[jgivoni](/maintainers/jgivoni)

---

Top Contributors

[![frankdejonge](https://avatars.githubusercontent.com/u/534693?v=4)](https://github.com/frankdejonge "frankdejonge (36 commits)")[![jgivoni](https://avatars.githubusercontent.com/u/1019332?v=4)](https://github.com/jgivoni "jgivoni (33 commits)")[![twistor](https://avatars.githubusercontent.com/u/42400?v=4)](https://github.com/twistor "twistor (8 commits)")[![nao-pon](https://avatars.githubusercontent.com/u/1412630?v=4)](https://github.com/nao-pon "nao-pon (2 commits)")[![weotch](https://avatars.githubusercontent.com/u/77567?v=4)](https://github.com/weotch "weotch (2 commits)")[![yellow1912](https://avatars.githubusercontent.com/u/374134?v=4)](https://github.com/yellow1912 "yellow1912 (2 commits)")[![shadowhand](https://avatars.githubusercontent.com/u/38203?v=4)](https://github.com/shadowhand "shadowhand (2 commits)")[![jonny-no1](https://avatars.githubusercontent.com/u/282458?v=4)](https://github.com/jonny-no1 "jonny-no1 (1 commits)")[![Nyholm](https://avatars.githubusercontent.com/u/1275206?v=4)](https://github.com/Nyholm "Nyholm (1 commits)")[![obj63mc](https://avatars.githubusercontent.com/u/443120?v=4)](https://github.com/obj63mc "obj63mc (1 commits)")[![Perturbatio](https://avatars.githubusercontent.com/u/1007702?v=4)](https://github.com/Perturbatio "Perturbatio (1 commits)")[![stijnvdb88](https://avatars.githubusercontent.com/u/4498834?v=4)](https://github.com/stijnvdb88 "stijnvdb88 (1 commits)")[![afurculita](https://avatars.githubusercontent.com/u/3129631?v=4)](https://github.com/afurculita "afurculita (1 commits)")[![zaak](https://avatars.githubusercontent.com/u/803299?v=4)](https://github.com/zaak "zaak (1 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (1 commits)")[![deviantintegral](https://avatars.githubusercontent.com/u/255023?v=4)](https://github.com/deviantintegral "deviantintegral (1 commits)")[![eXtreme](https://avatars.githubusercontent.com/u/197671?v=4)](https://github.com/eXtreme "eXtreme (1 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (1 commits)")[![hcomnetworkers](https://avatars.githubusercontent.com/u/15338688?v=4)](https://github.com/hcomnetworkers "hcomnetworkers (1 commits)")[![johnnoel](https://avatars.githubusercontent.com/u/1096330?v=4)](https://github.com/johnnoel "johnnoel (1 commits)")

---

Tags

filesystemFlysystemperformancemetadatacacheadapterpsr-6decoratorflysystem 3

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/jgivoni-flysystem-cache-adapter/health.svg)

```
[![Health](https://phpackages.com/badges/jgivoni-flysystem-cache-adapter/health.svg)](https://phpackages.com/packages/jgivoni-flysystem-cache-adapter)
```

###  Alternatives

[symfony/cache

Provides extended PSR-6, PSR-16 (and tags) implementations

4.2k373.5M3.3k](/packages/symfony-cache)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[cache/filesystem-adapter

A PSR-6 cache implementation using filesystem. This implementation supports tags

726.0M91](/packages/cache-filesystem-adapter)[matthiasmullie/scrapbook

Scrapbook is a PHP cache library, with adapters for e.g. Memcached, Redis, Couchbase, APCu, SQL and additional capabilities (e.g. transactions, stampede protection) built on top.

3232.8M45](/packages/matthiasmullie-scrapbook)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M577](/packages/shopware-core)[laminas/laminas-cache

Caching implementation with a variety of storage options, as well as codified caching strategies for callbacks, classes, and output

1077.3M154](/packages/laminas-laminas-cache)

PHPackages © 2026

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