mongodb/mongo-php-driver 2.3.0 on GitHub

The PHP team is happy to announce that version 2.3.0 of the MongoDB PHP extension is now available.

Release Highlights

Added support for MongoDB's Intelligent Workload Management (IWM) and ingress connection rate limiting features. The driver now gracefully handles write-blocking scenarios and optimizes connection establishment during high-load conditions to maintain application availability.
- Supported on all commands.
- Custom application retry logic may need to be adjusted to avoid retrying too long.
- Upgrade is recommended to avoid impacts of server changes related to overload errors.
  - If not upgrading, custom application retry logic may need to be adjusted to handle higher rates of overload errors. See Overload Errors.
- Add URI option maxAdaptiveRetries to configure the maximum number of retries for operations that fail with a SystemOverloadedError (default: 2).
- Add URI option enableOverloadRetargeting to control whether retries of SystemOverloadedError will attempt to use a different server (default: false).
Add typed, read-only properties for value objects and events (not BSON)
Base64 encode binary data when debugging
Deprecate hedge option in ReadPreference
Require non-null namespace and database arguments in Manager
Fix cloning Javascript objects without a scope
Out-of-source build: Don't necessarily generate files in the source tree by @vector-of-bool
Avoid string length calculations for bson_append calls

A complete list of resolved issues in this release may be found in JIRA.

Server compatibility

MongoDB 4.4+ Required: Future versions of the library will require MongoDB 4.4 or later. MongoDB 4.2 support is deprecated.

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pie install mongodb/mongodb-extension:2.3.0

Sources and Windows binaries are attached to the GitHub release notes.