NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4360 most downloaded on Packagist
Neo4j-PHP-Client is the most advanced PHP Client for Neo4j
Latest stable
3.7.1
Last release 1 months ago
22 Oct 2026
Ships fairly regularly
a new release about every 2 months
Most releases are documented
notes for 53 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
80 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Sessions now buffer the previous auto-commit result before running the next query, so earlier writes are visible and their locks are released. This fi
Bug fixes & reliability
LockAcquisitionTimeout and out-of-order writes between consecutive queries in a session (#283, #333).runStatements() retries each statement on its own again, so a retry no longer re-runs statements that already committed (#333).Note for extenders
BoltConnection::subscribeResult() now takes a BoltResult instead of a CypherList. This only affects code that subclasses BoltConnection or calls the method directly.d6d90e4
This commit was created on GitHub.com and signed with GitHub’s verified signature .
GPG key ID: B5690EEEBB952194
Verified Learn about vigilant mode .
Bug fixes & reliability
Sessions now buffer the previous auto-commit result before running the next query, so earlier writes are visible and their locks are released. This fixes LockAcquisitionTimeout and out-of-order writes between consecutive queries in a session ( #283 , #333 ).
runStatements() retries each statement on its own again, so a retry no longer re-runs statements that already committed ( #333 ).
Buffered results no longer lose rows ("Cannot rewind cursor"), and summary/bookmark callbacks run when the summary arrives ( #333 ).
The home database is now resolved once per session instead of on every connection acquire ( #332 ).
Note for extenders
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Connection liveness checks: idle pooled connections can be probed before reuse. Configure with DriverConfiguration::withConnectionLivenessCheckTimeout
New features
DriverConfiguration::withConnectionLivenessCheckTimeout(?float $seconds) (null disables, 0 always probes) (#328).SessionConfiguration::withBookmarksEnabled(false), so they are never sent or updated. This helps avoid BookmarkTimeout errors when causal consistency across sessions isn't needed (#330).Bug fixes & reliability
LockAcquisitionTimeout when running multiple statements with runStatements() (#327). Superseded by a more general fix in 3.7.1.Co-authored-by: Tom Swinkels tom.swinkels@prepr.io
Co-authored-by: Pratiksha Zalte pratiksha@nagels.tech
Co-authored-by: Cursor cursoragent@cursor.com
Fixed getDriver() draining configured driver setups after a failed connectivity check (foreach on SplPriorityQueue), which caused later calls to repor
Bug fixes & reliability
getDriver() draining configured driver setups after a failed connectivity check (foreach on SplPriorityQueue), which caused later calls to report empty URIs (Uris: ('')). Queue is now cloned before iteration (#324).Driver / TestKit / internals
TestClientAgentStringsV5x2 / V5x3) to the driver-parameters suite (test harness only).Session::executeQuery(): runs Cypher with automatic retry on transient errors (Bolt & Basic sessions).
New features
Bug fixes & reliability
Driver / TestKit / internals
Multi-driver failover (#282): If a configured host is unreachable, the client automatically retries on alternative drivers in the pool. Useful for mul
New features
Bug fixes & reliability
Driver / TestKit / internals
Documentation
Tests added
Neo4j Vector type : Support for the Neo4j Vector type in the client (#290).
f978584
This commit was created on GitHub.com and signed with GitHub’s verified signature .
GPG key ID: B5690EEEBB952194
Verified Learn about vigilant mode .
Neo4j Vector type : Support for the Neo4j Vector type in the client ( #290 ).
Connection receive timeout: Implements the connection receive-timeout configuration hint; connection/timeout failures are no longer misclassified as NotALeader, and related error handling is tightened in Bolt paths and testkit ( #279 ).
Relationship element IDs: Correct handling of relationship start/end node elementIds ( #292 ).
Type casting: TypeCaster improvements: toBool fix, other optimizations, InvalidTypeCast / tryToString refactor, plus unit tests ( #296 ).
Testkit: CI validation of the pinned testkit commit to avoid version drift ( #288 ).
Small hotfix where the driver halts if the server agent is not provided by the server autentication response
Small hotfix where the driver halts if the server agent is not provided by the server autentication response
Added support for forcing socket type via driver configuration (with SocketType enum)
fixed all the basic-query testkit tests
What’s new: TestKit integration, CI/CD speed boosts, connection-pooling improvements, and the removal of legacy HTTP support.
What’s new: TestKit integration, CI/CD speed boosts, connection-pooling improvements, and the removal of legacy HTTP support.
Re-enabled Features
Improvements CI/CD optimizations
Connection pooling
Bug Fixes
⚠️ Breaking Changes
📚 Miscellaneous
Addressed PHP 8.4 deprecations.
PSR LoggerInterface for enhanced logging.3.2.0: Update bolt, added Logger and improved error handling
Compare
optimised ci to use docker compose instead of github service containers
3.1.3: fix critical bug and optimise ci
Compare
fix: Double results when iterating after deserialization by @exaby73 in https://github.com/neo4j-php/neo4j-php-client/pull/221
Full Changelog: https://github.com/neo4j-php/neo4j-php-client/compare/3.1.1...3.1.2
Full Changelog: 3.1.1...3.1.2
Added support for Bolt 5.1 and 5.2
Fixed bug in address name resolution
Fixed some typing issues Fixed correct passing of driver configuration in client and client builder
Fixed some typing issues Fixed correct passing of driver configuration in client and client builder
removed deprecated dependencies in #183
Added a hasDriver method to query the client of an existence of a driver with a given alias
hasDriver method to query the client of an existence of a driver with a given aliasAdded functionality for binding transactions and sessions to optimise performance
Fixed a bug when dns_get_record returns false
more flexible dependencies for caching libraries
correct overloading of certain methods
- Fixed a bug when using php 8.2
Fixed bug in the connection pooling algorithm
correctly passed bookmarks when using basic formatter
Implemented connection resolver with PHP implementation or SysVSem
Bookmarks are now automatically handled by the Session class
Fixed bugs when working with results in neo4j 3.5
Fixed bugs when working with results in neo4j 3.5
Fixed bug when trying to dump an unconsumed result
Added HTTP Jolt protocol for OGM improvements in Neo4j
Fixed a regression when working with Neo4J 3.5 to enforce proper result consumption
Fixed a regression when working with Neo4J 3.5 to enforce proper result consumption
Added keyby, pluck and toArrayRecursive methods on sequences
New features:
keyby, pluck and toArrayRecursive methods on sequencesPerformance Increases:
Bugfixes
Fixed a bug in the authentication logic when working with the neo4j scheme.
Fixed a bug in the authentication logic when working with the neo4j scheme.
Nothing published for this version
Fixed bug when working with clusters with SSL and AuraDB
Fixed bug when working with clusters with SSL and AuraDB
Removed the usage of unnecessary keywords such as UNWIND by the driver to improve portability between neo4j instances and configurations.
UNWIND by the driver to improve portability between neo4j instances and configurations.Timeout is now correctly configurable on every transaction
Nothing published for this version
Made it possible to configure some SSL parameters in the driver configuration object. examples include:
Made it possible to configure some SSL parameters in the driver configuration object. examples include:
$config = DriverConfiguration::default()
->withSslConfiguration(
SslConfiguration::default()
->withVerifyPeer(false) //disables peer verification
->withMode(SslMode::FROM_URL()) // looks at the URL to determine the enabling of ssl
);
$driver = \Laudis\Neo4j\Basic\Driver::create('neo4j+s://localhost', $config);
$client = \Laudis\Neo4j\ClientBuilder::create()
->withDefaultDriverConfiguration($config)
->withDriver('default', 'neo4j+s://localhost')
->build();
Fixed a bug when using the HTTP protocol in combination with neo4j version 3.5
Fixed a bug when using the HTTP protocol in combination with neo4j version 3.5
The HTTP OGM has been completely reworked to correctly differentiate maps, lists, nodes, relationships and paths
The HTTP OGM has been completely reworked to correctly differentiate maps, lists, nodes, relationships and paths
The summarized result is now completely JSON serializable
The summarized result is now completely JSON serializable
upgraded authentication to support OIDC on bolt connections with neo4j 4.4 and up. See Laudis\Neo4j\Authentication\Authenticate::oidc
Laudis\Neo4j\Authentication\Authenticate::oidcLaudis\Neo4j\Authentication\DriverUnsolveable deprecations are now being suppressed (JsonSerializable::jsonSerialize())
JsonSerializable::jsonSerialize())A stream will now be correctly handled when it is reused
Set the default resultformatter to SummarisedResultFormatter
$container->getAsInt(0) or $map->getAsNode('myNode')created verifyConnectivity method on Client to test if a connection can be made correctly
Nothing published for this version
A Path in cypher will now be correctly handled by the driver
getPropertyFixed bug when serializing empty cypher map
All classes and methods have now been documented.
Nothing published for this version
The php-ds library and extension are now removed.
Upgraded to bolt version with route message
Nothing published for this version
Cypher statements with periodic commits can now be used when working with auto committed queries
Fixed SSL configuration bug when connecting to neo4j aura in pro or free tiers
Nothing published for this version
Used optional template arguments to streamline create methods on drivers.
2.0.1 shed light on another small bug when using the deprecated bolt methods on the client builder while not connecting via SSL. This has been fixed
2.0.1 shed light on another small bug when using the deprecated bolt methods on the client builder while not connecting via SSL. This has been fixed
One column per quarter.