Download the PHP package cache/filesystem-adapter without Composer
On this page you can find all versions of the php package cache/filesystem-adapter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cache/filesystem-adapter
More information about cache/filesystem-adapter
Files in cache/filesystem-adapter
Package filesystem-adapter
Short Description A PSR-6 cache implementation using filesystem. This implementation supports tags
License MIT
Homepage https://www.php-cache.com/en/latest/
Informations about the package filesystem-adapter
Filesystem PSR-6 cache pool
This package provides PSR-6 and PSR-16 cache implementations backed by Flysystem. It supports Flysystem 2.x and 3.x.
Installation
Usage
The pool stores entries in the cache directory by default. Pass another directory to the constructor when needed:
Version 3 hashes each key with SHA-256 and stores it in one of 256 shard directories. This keeps filenames portable and limits directory size.
Use the accessors when an extending app needs to inspect or replace the Flysystem instance or cache directory:
setFolder() normalizes forward and backward slashes. It removes empty and current-directory segments such as ..
It rejects folders that resolve to the Flysystem root or contain a parent-directory segment such as cache/... The constructor applies the same checks to its folder argument.
setFilesystem() creates the current cache directory on the replacement filesystem.
Custom file layouts
Subclass FilesystemCachePool and override getFilePath() to customize the default sharded layout. Call the parent method first to keep the portable key hash.
Return a deterministic path below getFolder() for every item and internal tag-index key. Use filesystem-portable path components, and do not derive them directly from untrusted cache keys. Paths outside the configured cache folder are not found by clear().
Use a dedicated cache folder. clear() searches nested directories and removes every file below the configured folder.
Upgrading to version 3
Version 3 stores files under SHA-256-based shard paths instead of raw cache-key filenames. It also stores generation metadata for tagged items. Version 2 workers cannot safely share either format.
Stop or drain all workers, clear the cache directory, and then deploy version 3. Follow the same sequence before a rollback.
Contributing
Send pull requests to the main repository. Report issues on the GitHub issue tracker.
All versions of filesystem-adapter with dependencies
cache/adapter-common Version ^3.0
league/flysystem Version ^2.0 || ^3.0
psr/cache Version ^3.0
psr/simple-cache Version ^2.0 || ^3.0