NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist
A simple cache library to manage application cache storing, loading and purging
Latest stable
7.0.0
Last release 21 days ago
31 Oct 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 52 of 56 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
56 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Remove the legacy numeric-generation cache protocol (Cache::legacy(), the Legacy facade, Feature\Legacy and its adapter forwarding/Lua). This is a bre
Remove the legacy numeric-generation cache protocol (Cache::legacy(), the Legacy facade, Feature\Legacy and its adapter forwarding/Lua). This is a breaking API cleanup; the eviction-safe opaque CAS and writer coordination protocol remains unchanged.
Add Cache::withNamespace() as an independent view of the same backing cache. Purge recordings retain logical keys for replay. Cloud uses the existing v2: prefix to preserve warm data and cache identities while rolling from Bridge v2 to the replacement code; no cache flush or separate cache service is required. Keep old bridge images explicitly configured as v2 while they remain deployable rollback targets.
Published through the Appwrite monorepo release workflow from merged, checked commit 6f74288569b54991e922c36f7c8ac75360ef2970. Namespace, Redis/multiplexing eviction and released-bridge interoperability checks pass. See Appwrite #15150 for validation and consumer dependencies.
Changes: https://github.com/appwrite/appwrite/compare/cache/6.1.3...cache/7.0.0
Preserve application list-cache behavior during the temporary rolling migration from cache 5.
Preserve application list-cache behavior during the temporary rolling migration from cache 5.
Validation: 138 unit tests (4 existing skips), 128 transport tests /548 assertions, and package formatting, PHPStan and Rector checks. Redis and multiplexing regressions cover TTLs, warm batch fields, circuit-breaker forwarding and the released wire format.
For Appwrite's three-pass rolling bridge, use this release with database 9.1.1 or newer. Previous tags remain unchanged. This release does not deploy Appwrite Cloud.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Complete the versioned-cache contracts used by the rolling migration bridge:
Complete the versioned-cache contracts used by the rolling migration bridge:
0 hash sentinel for default-field writes and whole-key purges.Validation: 138 unit tests /313 assertions (four existing skips), 128 transport tests /534 assertions, Rector, Pint, PHPStan and the GitHub cache package gate pass. The cache-5 wire format and the 6.1.1 grace-window correction are preserved. Database 9.1.0 is compatible with this patch.
Review and changes · Changes since 6.1.1
For Appwrite rolling migrations, use cache 6.1.3 or newer: it preserves expiring list-version markers and legacy batch fills.
Fix the temporary legacy migration facade when a nonzero fill-grace window is configured. Ordinary owner registrations now bypass the fill-only grace
Fix the temporary legacy migration facade when a nonzero fill-grace window is configured. Ordinary owner registrations now bypass the fill-only grace check, so rapid successive writes can proceed; conditional fills still respect the grace window.
This is required for the database 9.1 rolling bridge with Cloud's 1,000ms setting. Both Redis transports reproduce the regression on 6.1.0 and pass with the correction. The normal opaque v2 path is unchanged.
Validation: 136 unit tests /299 assertions (four existing skips), 128 transport tests /518 assertions, Rector, Pint, PHPStan, and the GitHub cache package gate pass. Real SQL successive-write coverage also passes in all three migration phases.
fix(cache): reject opaque operations in the legacy facade
Changes: https://github.com/appwrite/appwrite/compare/cache/6.0.0...cache/6.1.0
Migration note: use 6.1.1 for the rolling bridge. It corrects ordinary legacy registrations when a nonzero fill-grace window is configured; conditional fills remain fenced. The normal opaque v2 path is unchanged.
Breaking changes: remove numeric generation leases and Feature\Leasable; use opaque versions, atomic snapshots and compare-and-swap. CAS returns the c…
Cache 6.0.0
Source: CI-green Appwrite commit d277e35ffcaaa575318ba5edd67dcc1507757e00; cache split 2fef3be8b1aee62b831625a03b221c8e041c7328.
Breaking changes: remove numeric generation leases and Feature\Leasable; use opaque versions, atomic snapshots and compare-and-swap. CAS returns the committed version or false on conflict; errors throw. Versioned operations respect circuit-breaker OPEN, failure counting and half-open recovery. Redis, multiplexed Redis and Memory support versioning; unsupported adapters refuse conditional fills.
If using Utopia Database, upgrade to database 9.x with cache 6.x. Drain all legacy writers, clear disposable cache data, deploy matching versions everywhere, then resume. Successful post-commit invalidation is still necessary.
Also includes the accumulated Redis lost-reply/timeout socket handling and filesystem flush fixes since 5.2.0, including dot-prefixed entries, preservation of the root directory, and propagation of deletion failures.
First release cut from `packages/cache` in appwrite/appwrite.
First release cut from packages/cache in appwrite/appwrite.
fix(cache): park the multiplexing reader through idle gaps instead of retiring per command
Changes: https://github.com/utopia-php/monorepo/compare/cache/5.1.0...cache/5.1.1
bench(cache): drop the multiplexing adapter from the codec matrix
Changes: https://github.com/utopia-php/monorepo/compare/cache/5.0.4...cache/5.1.0
fix(cache): let the multiplexing reader retire while nothing is outstanding
Changes: https://github.com/utopia-php/monorepo/compare/cache/5.0.3...cache/5.0.4
test(cache): batch tests use loadMany/saveMany
Changes: https://github.com/utopia-php/monorepo/compare/cache/5.0.2...cache/5.0.3
chore: normalize recently absorbed packages
Changes: https://github.com/utopia-php/monorepo/compare/cache/5.0.1...cache/5.0.2
chore: stop committing package lock files
Changes: https://github.com/utopia-php/monorepo/compare/cache/5.0.0...cache/5.0.1
cache: require circuit-breaker ^0.4
Changes: https://github.com/utopia-php/monorepo/compare/cache/4.0.2...cache/5.0.0
(fix): preserve empty objects in JSON-backed caches
Changes: https://github.com/utopia-php/monorepo/compare/cache/4.0.1...cache/4.0.2
First release cut from the utopia-php monorepo.
First release cut from the utopia-php monorepo.
utopia-php/pools is now 2.*. Cache\Adapter\Pool::__construct() takes a Utopia\Pools\Pool in its public signature, so callers must construct a pools 2
utopia-php/pools is now 2.*. Cache\Adapter\Pool::__construct() takes a Utopia\Pools\Pool in its public signature, so callers must construct a pools 2 pool: timeout is a required constructor argument, the setRetry* / setReconnect* / setTelemetry setters are gone, and Connection is final readonly. See the pools upgrade guide.
Cache's own API is unchanged — the adapter only ever calls $pool->use().
Full Changelog: https://github.com/utopia-php/cache/compare/3.4.0...4.0.0
perf(cache): dispatch lease scripts via EVALSHA to unblock the shared connection by @abnegate in https://github.com/utopia-php/cache/pull/81
Full Changelog: https://github.com/utopia-php/cache/compare/3.3.0...3.4.0
feat(cache): make the Multiplexing adapter Leasable (lease + purge tombstone) by @abnegate in https://github.com/utopia-php/cache/pull/80
Full Changelog: https://github.com/utopia-php/cache/compare/3.2.0...3.3.0
ci: matrix tests by adapter as well as PHP version by @abnegate in https://github.com/utopia-php/cache/pull/78
Full Changelog: https://github.com/utopia-php/cache/compare/3.1.0...3.2.0
feat(cache): Leasable primitive to close the cache read-after-write race by @abnegate in https://github.com/utopia-php/cache/pull/75
Full Changelog: https://github.com/utopia-php/cache/compare/3.0.2...3.1.0
fix: create telemetry instruments lazily on first use by @loks0n in https://github.com/utopia-php/cache/pull/73
Full Changelog: https://github.com/utopia-php/cache/compare/3.0.1...3.0.2
feat: hit/miss counter + fix multiplexing pending-depth gauge by @loks0n in https://github.com/utopia-php/cache/pull/72
Full Changelog: https://github.com/utopia-php/cache/compare/3.0.0...3.0.1
refactor: extract Retryable into a Feature interface by @loks0n in https://github.com/utopia-php/cache/pull/71
Full Changelog: https://github.com/utopia-php/cache/compare/2.1.0...3.0.0
feat: add Redis\Multiplexing adapter over Swoole TCP by @loks0n in https://github.com/utopia-php/cache/pull/70
Full Changelog: https://github.com/utopia-php/cache/compare/2.0.0...2.1.0
Add circuit breaker cache adapter by @ChiragAgg5k in https://github.com/utopia-php/cache/pull/69
Full Changelog: https://github.com/utopia-php/cache/compare/1.0.3...2.0.0
Add cache touch support by @TorstenDittmann in https://github.com/utopia-php/cache/pull/68
Full Changelog: https://github.com/utopia-php/cache/compare/1.0.2...1.0.3
fix: add timeout detection to connection error handling by @abnegate in https://github.com/utopia-php/cache/pull/66
Full Changelog: https://github.com/utopia-php/cache/compare/1.0.1...1.0.2
Flush db vs all by @abnegate in https://github.com/utopia-php/cache/pull/64
Full Changelog: https://github.com/utopia-php/cache/compare/1.0.0...1.0.1
Implement Reconnection for caches by @premtsd-code in https://github.com/utopia-php/cache/pull/61
Full Changelog: https://github.com/utopia-php/cache/compare/0.13.3...1.0.0
Updated pools adapter by @ArnabChatterjee20k in https://github.com/utopia-php/cache/pull/60
Full Changelog: https://github.com/utopia-php/cache/compare/0.13.2...0.13.3
Update deps by @abnegate in https://github.com/utopia-php/cache/pull/58
Full Changelog: https://github.com/utopia-php/cache/compare/0.13.1...0.13.2
Revert "Enforce multiplatform case sensitivity" by @abnegate in https://github.com/utopia-php/cache/pull/54
Full Changelog: https://github.com/utopia-php/cache/compare/0.13.0...0.13.1
Feat pool adapter by @abnegate in https://github.com/utopia-php/cache/pull/53
Full Changelog: https://github.com/utopia-php/cache/compare/0.12.0...0.13.0
feat: add telemetry by @loks0n in https://github.com/utopia-php/cache/pull/52
Full Changelog: https://github.com/utopia-php/cache/compare/0.11.0...0.12.0
feat: add redis cluster adapter by @basert in https://github.com/utopia-php/cache/pull/45
Full Changelog: https://github.com/utopia-php/cache/compare/0.10.2...0.11.0
Redis default hash assignment by @shimonewman in https://github.com/utopia-php/cache/pull/43
Full Changelog: https://github.com/utopia-php/cache/compare/0.10.1...0.10.2
Fix list function by @fogelito in https://github.com/utopia-php/cache/pull/42
Full Changelog: https://github.com/utopia-php/cache/compare/0.10.0...0.10.1
move tests to github action by @lohanidamodar in https://github.com/utopia-php/cache/pull/39
Full Changelog: https://github.com/utopia-php/cache/compare/0.9.1...0.10.0
Refactor adapter filesystem::save by @shimonewman in https://github.com/utopia-php/cache/pull/38
Full Changelog: https://github.com/utopia-php/cache/compare/0.9.0...0.9.1
Hazelcast Adpater added, closes #3973 by @kaggrwal in https://github.com/utopia-php/cache/pull/28
Full Changelog: https://github.com/utopia-php/cache/compare/0.8.0...0.9.0
Added ping method to check cache connectivity by @eldadfux in https://github.com/utopia-php/cache/pull/27
Full Changelog: https://github.com/utopia-php/cache/compare/0.7.0...0.8.0
Sharding adapter by @eldadfux in https://github.com/utopia-php/cache/pull/20
Full Changelog: https://github.com/utopia-php/cache/compare/0.6.1...0.7.0
flatten getPath by @shimonewman in https://github.com/utopia-php/cache/pull/19
Full Changelog: https://github.com/utopia-php/cache/compare/0.6.0...0.6.1
Update case-sensitivify default + imrpove tests by @Meldiron in https://github.com/utopia-php/cache/pull/18
Full Changelog: https://github.com/utopia-php/cache/compare/0.5.0...0.6.0
Feat: Case Insensivity by @Meldiron in https://github.com/utopia-php/cache/pull/17
Full Changelog: https://github.com/utopia-php/cache/compare/0.4.2...0.5.0
Improve PHPUnit fixtures and file permissions by @peter279k in https://github.com/utopia-php/cache/pull/5
Full Changelog: https://github.com/utopia-php/cache/compare/0.4.1...0.4.2
The types of the $cache->save() method have been updated to handle arrays as well as strings.
- Added a new Memory adapter - Added a new None adapter
Added a new Redis adapter for caching
Updated tests, CI, coding standard and added some minor fixes based on Psalm analysis.
Updated tests, CI, coding standard and added some minor fixes based on Psalm analysis.
Nothing published for this version
Optimized PHP performance by using fully-qualified function calls.
Optimized PHP performance by using fully-qualified function calls.
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.