NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3567 most downloaded on Packagist
Common classes for non-blocking SQL implementations.
Latest stable
v2.0.5
Last release 19 days ago
03 Nov 2026
Release timing varies
gaps range from 8 days to 11 months
Nearly every release is documented
notes for 13 of 14 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
24 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Release the connection when the statement pool declines to retain a statement by @webpatser in https://github.com/amphp/sql-common/pull/8
Full Changelog: https://github.com/amphp/sql-common/compare/v2.0.4...v2.0.5
Full Changelog: v2.0.4...v2.0.5
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix PHP 8.5 deprecation by @luzrain in #7
Full Changelog: https://github.com/amphp/sql-common/compare/v2.0.3...v2.0.4
Added a reference to $this in the returned Generator from SqlPooledResult::getIterator() to prevent destruction of the SqlPooledResult while the retur
$this in the returned Generator from SqlPooledResult::getIterator() to prevent destruction of the SqlPooledResult while the returned Generator object exists.Full Changelog: v2.0.2...v2.0.3
Fixed a memory leak due to SqlStatementPool accumulating on-close callbacks in SqlCommonConnectionPool .
SqlStatementPool accumulating on-close callbacks in SqlCommonConnectionPool.Full Changelog: v2.0.1...v2.0.2
Changed syntax in SqlCommonConnectionPool when awaiting a Future to attempt to address a crash possibly caused by PHP opcache.
SqlCommonConnectionPool when awaiting a Future to attempt to address a crash possibly caused by PHP opcache.Full Changelog: v2.0.0...v2.0.1
Stable release compatible with AMPHP v3 and fibers! 🎉
Stable release compatible with AMPHP v3 and fibers! 🎉
As with other libraries compatible with AMPHP v3, most cases of parameters or returns of Promise<ResolutionType> have been replaced with ResolutionType.
Sql as a prefix to avoid name collisions with other libraries.ConnectionPool to SqlCommonConnectionPool.SqlNestedableTransactionExecutor and SqlNestedTransaction to support nested transactions.SqlCommandResult and SqlConnectionTransaction.PooledResultSet to SqlPooledResult.yield from to a foreach loop to avoid a PHP bug which caused an infinite loop (see amphp/mysql#133).Full Changelog: v2.0.0-beta.9...v2.0.0-beta.10
PooledResult not releasing the underlying result set until destruction when using fetchRow() to consume the result.Full Changelog: v2.0.0-beta.8...v2.0.0-beta.9
amphp/sql@v2.0.0-beta.6.NestableTransaction and TransactionDelegate.NestedTransaction to act as a base class for nested transactions created using Transaction::beginTransaction().ConnectionTransaction for use as a base class for transactions started on a connection.NestableTransactionExecutor interface, used with ConnectionTransaction and NestedTransaction.Full Changelog: v2.0.0-beta.6...v2.0.0-beta.7
PooledResult.ConnectionTransaction using separate prepare and execute in execute() instead of calling NestableTransactionExecutor::execute() directly.Full Changelog: v2.0.0-beta.7...v2.0.0-beta.8
Swapped a use of yield from to a foreach loop to avoid a PHP bug which caused an infinite loop (see amphp/mysql#133).
yield from to a foreach loop to avoid a PHP bug which caused an infinite loop (see amphp/mysql#133).Full Changelog: https://github.com/amphp/sql-common/compare/v2.0.0-beta.9...v2.0.0-beta.10
Fixed PooledResult not releasing the underlying result set until destruction when using fetchRow() to consume the result.
PooledResult not releasing the underlying result set until destruction when using fetchRow() to consume the result.Full Changelog: https://github.com/amphp/sql-common/compare/v2.0.0-beta.8...v2.0.0-beta.9
Fixed ConnectionTransaction using separate prepare and execute in execute() instead of calling NestableTransactionExecutor::execute() directly.
ConnectionTransaction using separate prepare and execute in execute() instead of calling NestableTransactionExecutor::execute() directly.Full Changelog: https://github.com/amphp/sql-common/compare/v2.0.0-beta.7...v2.0.0-beta.8
Updated transactions for `amphp/sql@v2.0.0-beta.6`.
amphp/sql@v2.0.0-beta.6.NestableTransaction and TransactionDelegate.NestedTransaction to act as a base class for nested transactions created using Transaction::beginTransaction().ConnectionTransaction for use as a base class for transactions started on a connection.NestableTransactionExecutor interface, used with ConnectionTransaction and NestedTransaction.Full Changelog: https://github.com/amphp/sql-common/compare/v2.0.0-beta.6...v2.0.0-beta.7
Removed automatically fetching the next result after iteration of a result in PooledResult.
PooledResult.Fixed PooledStatement not releasing the underlying statement immediately when closed.
PooledStatement not releasing the underlying statement immediately when closed.PooledResult if the result is an instance of CommandResult to allow freeing the backing connection sooner.CommandResult to be abstract — this class should be extended in extending libraries so PooledResult can detect if the result can be freed immediately.Added NestableTransaction and NestedTransaction which can be used to wrap an existing Transaction into a Link interface object, which can then create
NestableTransaction and NestedTransaction which can be used to wrap an existing Transaction into a Link interface object, which can then create a "nested" transaction using savepoints.Compatibility with Result::fetchRow() added in `amphp/sql@2.0.0-beta.3`
Result::fetchRow() added in amphp/sql@2.0.0-beta.3Fix Operation is no longer pending error
Operation is no longer pending errorInitial release compatible with AMPHP v3.
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.
amphp/sqlPooledResultSet to PooledResultcreateResultSet() methods renamed to createResult()RetryConnector to RetrySqlConnectorCommandResult classFixed potential double deferred resolve when a connection pool is full.
Fix destructor of PooledTransaction calling close() instead of the internal release callback. This had the side-effect of potentially committing a des
PooledTransaction calling close() instead of the internal release callback. This had the side-effect of potentially committing a destroyed transaction, which was certainly not the intended behavior of a destructor.Improved shrinking of connection pools after temporary surge in pool size
Simultaneous connection creation is now prevented in ConnectionPool. Attempting to create many connections simultaneously was causing unresponsive con
ConnectionPool. Attempting to create many connections simultaneously was causing unresponsive connection attempts with amphp/postgres, PHP 7.4, and Postgres 12. Each connection attempt now waits for any prior connection attempts to complete.Added RetryConnector that will attempt to connect a given number of times before failing.
RetryConnector that will attempt to connect a given number of times before failing.Fixed PooledResultSet objects not releasing the associated connection until destruction instead of after the result set was consumed (#2).
PooledResultSet objects not releasing the associated connection until destruction instead of after the result set was consumed (#2).Removed a circular reference in ConnectionPool.
ConnectionPool.Nothing published for this version
One column per quarter.