cache/filesystem-adapter
A PSR-6 cache implementation using filesystem. This implementation supports tags
3.0.0
6.2M downloads/mo
#2939 most downloaded on Packagist
php-cache/filesystem-adapter
What this package is like to depend on
Last release 4 days ago
20 Aug 2026
Ships unpredictably
gaps range from 2 weeks to 4.6 years
Most releases are documented
notes for 14 of 17 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
17 releases · first in 2016
6 releases in the last 12 months
see the full history below
Release timeline
17 releases · Jan 2016 to Aug 2026Releases
latest 17-
3.0.020 Aug 2026Release notes
Open source →Changed
- Expose
getFilePath()as a protected extension point for custom file layouts. - Hash keys into 256 shard directories to avoid platform-specific filenames and large flat directories.
- Clear cache files recursively so custom layouts can use nested directories.
- Require
cache/adapter-common3. - Store tag generations in item payloads and separate marker files. Clear the cache directory before upgrading or rolling back.
- Expose
-
2.0.419 Aug 2026Release notes
Open source →Fixed
- Treat serialized items and tag indexes that reference unavailable PHP classes as cache misses.
- Allow installing with
psr/simple-cache2 or 3.
-
2.0.319 Aug 2026Release notes
Open source →Reject unsupported filename keys from getItem() and map the PSR-required dot keys to portable internal filenames.
Release notes
Open source →Fixed
- Validate filesystem key constraints in
getItem()and safely store the PSR-required.and..keys.
- Validate filesystem key constraints in
-
2.0.218 Aug 2026 -
2.0.118 Aug 2026Release notes
Open source →keep Symfony-style test signatures and prevent the fixer from
restoring native void declarations. -
2.0.018 Aug 2026Release notes
Open source →declare standalone test dependencies and use a traversable Flysystem fixture.
Release notes
Open source →Added
- Add accessors for the Flysystem instance and cache directory.
Changed
- Require PHP 8.2 or later.
- Support Flysystem 2 and 3 through
FilesystemOperator. - Require
psr/cache3 andpsr/simple-cache3. - Add native parameter and return types required by the PSR interfaces.
- Normalize leading and trailing slashes in
setFolder().
Fixed
- Reject folder values that resolve to the Flysystem root or traverse through a parent directory.
-
1.2.015 Jan 2022Release notes
Open source →- Support for PHP 8.1
- Drop support for PHP < 7.4
- Allow psr/cache: ^1.0 || ^2.0
-
1.1.014 Dec 2020Release notes
Open source →Added
- Support for PHP 8
Changed
- Use
League\Flysystem\FilesystemInterfaceinstead of concreteLeague\Flysystem\Filesystemclass
-
1.0.016 Jul 2017 -
0.4.013 Mar 2017Release notes
Open source →Added
- Support for the new
TaggableCacheItemPoolInterface. - Support for PSR-16 SimpleCache
Changed
- The behavior of
CacheItem::getTags()has changed. It does not return tags stored in the cache storage.
Removed
CacheItem::getExpirationDate(). UseCacheItem::getExpirationTimestamp()CacheItem::getTags(). UseCacheItem::getPreviousTags()CacheItem::addTag(). UseCacheItem::setTags()
- Support for the new
-
0.3.325 Dec 2016 -
0.3.219 Oct 2016Release notes
Open source →Changed
- Using
Filesystem::updateinstead ofFilesystem::deleteandFilesystem::write.
- Using
-
0.3.107 Aug 2016 -
0.3.025 Feb 2016 -
0.2.124 Jan 2016Nothing published for this version
-
0.2.020 Jan 2016Nothing published for this version
-
0.1.006 Jan 2016Nothing published for this version