NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4067 most downloaded on Packagist
Efficient asynchronous communication with Redis servers, enabling scalable and responsive data storage and retrieval.
Latest stable
v2.0.4
Last release 8 months ago
03 Mar 2026
Release timing varies
gaps range from 3 weeks to 1.1 years
Nearly every release is documented
notes for 28 of 31 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
36 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Fix hget TypeError instead of returning null by @PNixx in #101
hget TypeError instead of returning null by @PNixx in https://github.com/amphp/redis/pull/101Full Changelog: https://github.com/amphp/redis/compare/v2.0.3...v2.0.4
Dropped support for league/uri@6.x
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixed return type for RedistList::get() by @Bilge in #96
Full Changelog: v2.0.1...v2.0.2
RedistList::get() by @Bilge in https://github.com/amphp/redis/pull/96Full Changelog: https://github.com/amphp/redis/compare/v2.0.1...v2.0.2
Fixed return type for RedistList::get() by @Bilge in #96
Full Changelog: v2.0.0...v2.0.1
RedistList::get() by @Bilge in https://github.com/amphp/redis/pull/96Full Changelog: https://github.com/amphp/redis/compare/v2.0.0...v2.0.1
Initial release compatible with AMPHP v3. As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise<ResolutionT
Initial release compatible with AMPHP v3. As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise<ResolutionType> have been replaced with ResolutionType.
RedisParcel in the Sync sub-namespace implementing the Parcel interface from amphp/syncRedisConnector interface to decouple connecting and init commands such as AUTH and SELECTRedis moved to RedisClientSubscriber / Subscription moved to RedisSubscriber / RedisSubscriptionCache moved to RedisCacheMutex sub-namespace has been changed to Sync. All classes within now have a prefix of Redis, e.g., Mutex → RedisMutex, MutexOptions → RedisMutexOptionsConfig moved to RedisConfigRespSocket moved to Amp\Redis\Connection\RedisConnection and is an interface nowRespParser moved to Amp\Redis\Protocol\RespParserQueryExecutor moved to Amp\Redis\Connection\RedisLinkRemoteExecutor moved to Amp\Redis\Connection\ReconnectingRedisLinkRedisHyperLogLog moved to Amp\Redis\Command\RedisHyperLogLogRedisList moved to Amp\Redis\Command\RedisListRedisMap moved to Amp\Redis\Command\RedisMapRedisSet moved to Amp\Redis\Command\RedisSetRedisSortedSet moved to Amp\Redis\Command\RedisSortedSetSortOptions moved to Amp\Redis\Command\Option\SortOptionsSetOptions moved to Amp\Redis\Command\Option\SetOptionsSocketException moved to Amp\Redis\Connection/RedisConnectionExceptionParserException moved to Amp\Redis\Protocol\ProtocolExceptionQueryException moved to Amp\Redis\Protocol\QueryExceptionRedisSubscription is now a simple PHP iterator now that Amp\Iterator is no longer necessary with fibers.Added compatibility with Revolt v1.x
Fix subscription calling unsubscribe if only iterator is retained
psr/log version constraint for wider compatibility (https://github.com/amphp/redis/pull/79)Initial release compatible with AMPHP v3. As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise have been r
Initial release compatible with AMPHP v3.
As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise<ResolutionType> have been replaced with ResolutionType.
RespSocket and RespParser have been moved the the Amp\Redis\Connection sub-namespace. RespSocket is now an interface implemented by DefaultRespParserRedisConnector interface and a single implementation, RedisSocketConnectorMutex sub-namespace has been changed to Sync. All classes within now have a prefix of Redis, e.g., Mutex → RedisMutex, MutexOptions → RedisMutexOptionsRedisParcel in the Sync sub-namespace implementing the Parcel interface from amphp/syncSubscription is now a simple PHP iterator now that Amp\Iterator is no longer necessary with fibers.Config → RedisConfigSetOptions → RedisSetOptionsSortOptions → RedisSortOptionsSocketException → RedisSocketExceptionFixed #84 : Unexpected connection close in RemoteExecutor causing method call on null.
RemoteExecutor causing method call on null.Fixed leaking non- RedisException from Subscriber connection errors.
RedisException from Subscriber connection errors.Fix deprecated string interpolation style
Added getRange() , getRangeWithScores() , getRangeByScore() , getRangeByScoreWithScores() , and getLexicographicRange() to RedisSortedSet ( #77 , #78
Fixed a case where an exception may be thrown to the event loop when a Subscriber lost connection to the Redis server.
Subscriber lost connection to the Redis server.Fixed Redis::getMultiple combining responses by @dmitry-pilipenko in https://github.com/amphp/redis/pull/72
Redis::getMultiple combining responses by @dmitry-pilipenko in https://github.com/amphp/redis/pull/72Fixed reconnect if initial connect fails
Fixed error handling on connection closure
RespSocket::write if the socket is closedFixed error when popTailBlocking returns null
popTailBlocking returns nullpopTailBlocking type informationpopTailPushHeadBlocking type informationFixed error when popHeadBlocking returns null
popHeadBlocking returns null (#64)popHeadBlocking type informationFixed timed out clients not removing themselves from the lock queue in Mutex
Mutex (#61)Changed to human readable names in favor of direct redis command names
Mutex implementation from kelunik/redis-mutexQueryExecutorredis:// URIsrestoreFromDump() → restore()Redis::getSorted() to RedisList::sort(), RedisSet::sort(), and RedisSortedSet::sort()setTtl() → getTtl(), setTtlInMillis() → getTtlInMillis()RedisHyperLogLog::storeMergeOf → RedisHyperLogLog::storeUnion()SetOptions::toSetQuery() → SetOptions::toQuery()SortOptions::isLexicographically() → SortOptions::isLexicographicSorting()SortOptions::getCount()*Note: This is a pre-release, there might be breaking changes in the final stable version.*
Note: This is a pre-release, there might be breaking changes in the final stable version.
ConfigConfig constructor is now private, please use Config::fromUri insteadMutex implementationRedis::expire() → Redis::expireIn()Redis::pauseInMillis() → Redis::pauseMillis()RedisMap::delete() → RedisMap::remove()RedisSet::isMember() → RedisSet::contains()RedisSet::move() to be consistent with Redis::move()RedisList::set() and RedisList::trim()RedisMap::getValues() and RedisMap::scan()scan commandsConnector parameter in constructor of RemoteExecutor / RemoteExecutorFactory*Note: This is a pre-release, there might be breaking changes in the final stable version.*
Note: This is a pre-release, there might be breaking changes in the final stable version.
Mutex implementation from kelunik/redis-mutexQueryExecutorredis:// URIsRollback of v0.3.4 / v0.3.5 allowing amphp/socket@^1, will be released as v1.0.0
amphp/socket@^1, will be released as v1.0.0AUTH and SELECT on connecting (#54)*Note: This release allowed amphp/socket@^1 only, which resulted in libraries requiring amphp/socket@^0.10 to install the broken v0.3.4. It was theref
Borked, don't use.
Note: This release allowed amphp/socket@^1 only, which resulted in libraries requiring amphp/socket@^0.10 to install the broken v0.3.4. It was therefore reverted. Please use v0.3.6 or v1.0.0 instead.
*Note: This release will not work with amphp/socket@^0.10. It was mistakenly left as an allowed dependency. Please use v0.3.6 or v1.0.0 instead.*
Borked, don't use.
Note: This release will not work with amphp/socket@^0.10. It was mistakenly left as an allowed dependency. Please use v0.3.6 or v1.0.0 instead.
Added annotation based deprecation notice for evalSha().
evalSha().\sha1() calls.Deprecated evalSha as eval automatically uses evalSha now.
evalSha.eval to have defaults for $keys and $args.eval to automatically use evalSha and fall back to eval if script is unknown.evalSha as eval automatically uses evalSha now.Fixed null pointer if connect immediately resolves.
hScan.Nothing published for this version
Fix setting the connect timeout
Deprecate options array, use query string parameters instead, see documentation.
Actual fix for large payloads / full write buffers.
Fix issues with large payloads / full write buffers.
Fixed unsubscribe mechanism in SubscribeClient.
SubscribeClient.Nothing published for this version
Nothing published for this version
One column per quarter.