NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #4285 most downloaded on Packagist
A simple library to manage application persistence using multiple database adapters
Latest stable
10.1.1
Last release 11 days ago
11 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
461 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
fix: refuse a non-string select value instead of fatalling on it by @abnegate in https://github.com/utopia-php/database/pull/931
Full Changelog: https://github.com/utopia-php/database/compare/7.1.0...7.1.1
feat: return the distance a vector query ranked by, and let the index answer it by @abnegate in https://github.com/utopia-php/database/pull/929
Full Changelog: https://github.com/utopia-php/database/compare/7.0.0...7.1.0
utopia-php/pools is now 2.* and utopia-php/cache is now ^4.0.0.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
utopia-php/pools is now 2.* and utopia-php/cache is now ^4.0.0.
Database\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.
The database API itself is unchanged — the adapter only ever calls $pool->use().
Full Changelog: https://github.com/utopia-php/database/compare/6.5.1...7.0.0
Exclude timeout exception by @fogelito in https://github.com/utopia-php/database/pull/927
Full Changelog: https://github.com/utopia-php/database/compare/6.5.0...6.5.1
Cache empty getDocument results by @fogelito in https://github.com/utopia-php/database/pull/924
Full Changelog: https://github.com/utopia-php/database/compare/6.4.5...6.5.0
<!-- puller-release:8e25478d-a128-4b7f-b832-9820798ffbb8 -->
<!-- puller-release:8e25478d-a128-4b7f-b832-9820798ffbb8 -->
Full Changelog: https://github.com/utopia-php/database/compare/6.4.4...6.4.5
fix: support isNull/isNotNull queries on spatial attributes by @HarshMN2345 in https://github.com/utopia-php/database/pull/922
Full Changelog: https://github.com/utopia-php/database/compare/6.4.3...6.4.4
Refetch documents by $sequence by @fogelito in https://github.com/utopia-php/database/pull/916
Full Changelog: https://github.com/utopia-php/database/compare/6.4.2...6.4.3
fix: operators limits by @fogelito in https://github.com/utopia-php/database/pull/911
Full Changelog: https://github.com/utopia-php/database/compare/6.4.1...6.4.2
fix(mongo): honour query timeout on count() and sum() aggregate paths by @abnegate in https://github.com/utopia-php/database/pull/913
Full Changelog: https://github.com/utopia-php/database/compare/6.4.0...6.4.1
Operators binds by @fogelito in https://github.com/utopia-php/database/pull/909
Full Changelog: https://github.com/utopia-php/database/compare/6.3.0...6.4.0
fix(cache): gate the query cache write on a lease to reject stale lists by @abnegate in https://github.com/utopia-php/database/pull/905
Full Changelog: https://github.com/utopia-php/database/compare/6.2.0...6.3.0
Add cache-aside helper by @premtsd-code in https://github.com/utopia-php/database/pull/900
Full Changelog: https://github.com/utopia-php/database/compare/6.1.0...6.2.0
refactor(transaction): postgres inherit startTransaction by @abnegate in https://github.com/utopia-php/database/pull/897
Full Changelog: https://github.com/utopia-php/database/compare/6.0.0...6.1.0
refactor(transaction): own connection recovery in the adapter, drop Swoole PDOProxy dependency by @abnegate in https://github.com/utopia-php/database/
Full Changelog: https://github.com/utopia-php/database/compare/5.9.4...6.0.0
fix(transaction): tolerate desynced cleanup rollback on startTransaction by @loks0n in https://github.com/utopia-php/database/pull/895
Full Changelog: https://github.com/utopia-php/database/compare/5.9.3...5.9.4
Bug update document uid with delete by @fogelito in https://github.com/utopia-php/database/pull/891
Full Changelog: https://github.com/utopia-php/database/compare/5.9.2...5.9.3
Retry transient transaction failures in the Mongo adapter by @ChiragAgg5k in https://github.com/utopia-php/database/pull/889
Full Changelog: https://github.com/utopia-php/database/compare/5.9.1...5.9.2
Add SQL trigger in getDocument by @fogelito in https://github.com/utopia-php/database/pull/880
Full Changelog: https://github.com/utopia-php/database/compare/5.9.0...5.9.1
chore: bump utopia-php/cache to 3.0 by @loks0n in https://github.com/utopia-php/database/pull/879
Full Changelog: https://github.com/utopia-php/database/compare/5.8.0...5.9.0
Upgrade utopia-php/cache requirement from 1.* to ^2.0.
utopia-php/cache requirement from 1.* to ^2.0.Full Changelog: https://github.com/utopia-php/database/compare/5.7.0...5.8.0
Optimize sum count method with no limit by @fogelito in https://github.com/utopia-php/database/pull/873
Full Changelog: https://github.com/utopia-php/database/compare/5.6.0...5.7.0
feat: Redis adapter by @abnegate in https://github.com/utopia-php/database/pull/872
Full Changelog: https://github.com/utopia-php/database/compare/5.5.0...5.6.0
feat(adapter): add support for upsert on unique index across database… by @ArnabChatterjee20k in https://github.com/utopia-php/database/pull/871
Full Changelog: https://github.com/utopia-php/database/compare/5.4.1...5.4.2
added _deletedAt to $deletedAt translation by @shimonewman in https://github.com/utopia-php/database/pull/602
Full Changelog: https://github.com/utopia-php/database/compare/5.4.0...5.4.1
Feat self healing prs by @abnegate in https://github.com/utopia-php/database/pull/862
Full Changelog: https://github.com/utopia-php/database/compare/5.3.22...5.4.0
feat(adapter): add support for upsert on unique index across database… by @ArnabChatterjee20k in https://github.com/utopia-php/database/pull/871
Full Changelog: https://github.com/utopia-php/database/compare/5.4.1...5.3.23
feat: add Query::fingerprint() for shape-only query hashing by @lohanidamodar in https://github.com/utopia-php/database/pull/859
Full Changelog: https://github.com/utopia-php/database/compare/5.3.21...5.3.22
feat: add StructureException handling for invalid datetime values in … by @ArnabChatterjee20k in https://github.com/utopia-php/database/pull/854
Full Changelog: https://github.com/utopia-php/database/compare/5.3.20...5.3.21
Aliases for Dotted attribute not getting removed during decode in sql by @ArnabChatterjee20k in https://github.com/utopia-php/database/pull/853
Full Changelog: https://github.com/utopia-php/database/compare/5.3.19...5.3.20
Abstract getDriver by @fogelito in https://github.com/utopia-php/database/pull/849
Full Changelog: https://github.com/utopia-php/database/compare/5.3.18...5.3.19
Sequence integer query test by @fogelito in https://github.com/utopia-php/database/pull/845
Full Changelog: https://github.com/utopia-php/database/compare/5.3.17...5.3.18
fix: prevent metadata table from being dropped by @abnegate in https://github.com/utopia-php/database/pull/843
Full Changelog: https://github.com/utopia-php/database/compare/5.3.16...5.3.17
fix: skip orphan reconciliation for shared tables in createCollection by @loks0n in https://github.com/utopia-php/database/pull/841
Full Changelog: https://github.com/utopia-php/database/compare/5.3.15...5.3.16
chore: replace utopia-php/framework with standalone packages by @loks0n in https://github.com/utopia-php/database/pull/837
Full Changelog: https://github.com/utopia-php/database/compare/5.3.14...5.3.15
Fix partial failure recreate by @abnegate in https://github.com/utopia-php/database/pull/839
Full Changelog: https://github.com/utopia-php/database/compare/5.3.13...5.3.14
Full Changelog: https://github.com/utopia-php/database/compare/5.3.12...5.3.13
Full Changelog: https://github.com/utopia-php/database/compare/5.3.12...5.3.13
Nothing published for this version
Nothing published for this version
Fix mongo perms by @abnegate in https://github.com/utopia-php/database/pull/835
Full Changelog: https://github.com/utopia-php/database/compare/5.3.9...5.3.10
Force strict equivalence in mongo role checks by @abnegate in https://github.com/utopia-php/database/pull/834
Full Changelog: https://github.com/utopia-php/database/compare/5.3.8...5.3.9
fix: re-encode updatedAt in increase/decreaseDocumentAttribute with preserveDates by @premtsd-code in https://github.com/utopia-php/database/pull/831
Full Changelog: https://github.com/utopia-php/database/compare/5.3.7...5.3.8
Add cache key tests by @abnegate in https://github.com/utopia-php/database/pull/828
Full Changelog: https://github.com/utopia-php/database/compare/5.3.6...5.3.7
Fix config state cache poisoning by @abnegate in https://github.com/utopia-php/database/pull/827
Full Changelog: https://github.com/utopia-php/database/compare/5.3.5...5.3.6
Fix type checks by @abnegate in https://github.com/utopia-php/database/pull/824
Full Changelog: https://github.com/utopia-php/database/compare/5.3.4...5.3.5
fix: enhance error handling during statement execution by @eldadfux in https://github.com/utopia-php/database/pull/821
Full Changelog: https://github.com/utopia-php/database/compare/5.3.3...5.3.4
DDL failure recovery by @abnegate in https://github.com/utopia-php/database/pull/820
Full Changelog: https://github.com/utopia-php/database/compare/5.3.2...5.3.3
Fix M2M relationship queries via API by @abnegate in https://github.com/utopia-php/database/pull/818
Full Changelog: https://github.com/utopia-php/database/compare/5.3.1...5.3.2
Fix transaction state management across adapters by @premtsd-code in https://github.com/utopia-php/database/pull/817
Full Changelog: https://github.com/utopia-php/database/compare/5.3.0...5.3.1
Normalize extended ISO 8601 datetime strings in query values for Mong… by @ArnabChatterjee20k in https://github.com/utopia-php/database/pull/814
Full Changelog: https://github.com/utopia-php/database/compare/5.2.1...5.3.0
Fix ghost perms by @abnegate in https://github.com/utopia-php/database/pull/813
Full Changelog: https://github.com/utopia-php/database/compare/5.2.0...5.2.1
Support mongo relationships by @abnegate in https://github.com/utopia-php/database/pull/812
Full Changelog: https://github.com/utopia-php/database/compare/5.1.2...5.2.0
Fix adapter check by @abnegate in https://github.com/utopia-php/database/pull/810
Full Changelog: https://github.com/utopia-php/database/compare/5.1.1...5.1.2
Filter use break by @fogelito in https://github.com/utopia-php/database/pull/808
Full Changelog: https://github.com/utopia-php/database/compare/5.1.0...5.1.1
Feat: Generator (yield) for forEach() by @Meldiron in https://github.com/utopia-php/database/pull/804
Full Changelog: https://github.com/utopia-php/database/compare/5.0.2...5.1.0
Cache clear new doc ID on rename by @abnegate in https://github.com/utopia-php/database/pull/802
Full Changelog: https://github.com/utopia-php/database/compare/5.0.1...5.0.2
Fix new string type valdiation by @abnegate in https://github.com/utopia-php/database/pull/800
Full Changelog: https://github.com/utopia-php/database/compare/5.0.0...5.0.1
Upgrade cache dependency for reconnection support by @premtsd-code in https://github.com/utopia-php/database/pull/797
Full Changelog: https://github.com/utopia-php/database/compare/4.6.3...5.0.0
Upgrade utopia-php/pools to 1.x by @hmacr in https://github.com/utopia-php/database/pull/799
utopia-php/pools to 1.x by @hmacr in https://github.com/utopia-php/database/pull/799Full Changelog: https://github.com/utopia-php/database/compare/4.6.3...4.6.4
Fix pool tests by @fogelito in https://github.com/utopia-php/database/pull/796
Full Changelog: https://github.com/utopia-php/database/compare/4.6.2...4.6.3
One column per quarter.