1.11.0

The PHP team is happy to announce that version 1.11.0 of the mongodb PHP extension is now available on PECL. This release completes support for new features in MongoDB 5.0.

Release Highlights

Manager::startSession() now supports a snapshot option, which allows read concern "snapshot" to be used for certain read operations outside of multi-document transactions on MongoDB 5.0+.

The driver now supports a loadBalanced URI option, which may be used when connecting to a MongoDB cluster behind a load balancer (e.g. Atlas Serverless).

Manager::selectServer() no longer requires a ReadPreference parameter. By default, the method will now attempt to select a primary server.

This release is compatible with PHP 8.1.0RC5 and adds support for the new custom object serialization mechanism introduced in PHP 7.4, which is now required with PHP 8.1 phasing out Serializable. Extensions classes that support serialization now implement __serialize() and __unserialize() methods to support the new format, in addition to retaining support for the old format (i.e. Serializable interface).

This release upgrades our libbson and libmongoc dependencies to 1.19.1.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=31529

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Installation

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

pecl install mongodb-1.11.0

or update with:

pecl upgrade mongodb-1.11.0

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.11.0alpha1

The PHP team is happy to announce that version 1.11.0alpha1 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release makes the extension compatible with PHP 8.1.0RC1. This primarily adds support for the new custom object serialization mechanism introduced in PHP 7.4, which is now required with PHP 8.1 phasing out Serializable. Extensions classes that support serialization now implement __serialize() and __unserialize() methods to support the new format, in addition to retaining support for the old format (i.e. Serializable interface).

Manager::startSession() supports a snapshot option, which allows read concern "snapshot" to be used for certain read operations outside of multi-document transactions on MongoDB 5.0+.

This release upgrades our libbson and libmongoc dependencies to 1.19.0.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=32025

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Installation

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

pecl install mongodb-1.11.0alpha1

or update with:

pecl upgrade mongodb-1.11.0alpha1

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.10.0

The PHP team is happy to announce that version 1.10.0 of the mongodb PHP extension is now available on PECL. This release adds support for new features in MongoDB 5.0.

Release Highlights

The Manager constructor now supports a serverApi option in its $driverOptions parameter. A ServerApi instance can be provided to this option to utilize the new Stable API feature in MongoDB 5.0 and later.

Azure Key Vault and Google Cloud Platform KMS are now supported as keystores for client-side field-level encryption. They may be configured via kmsProviders field of the autoEncryption driver option when constructing a Manager.

The driver no longer prohibits the use of dots and dollars in document fields names. Restrictions are now entirely enforced by the server. Although MongoDB 5.0 has relaxed several restrictions, features such as escaping syntax for queries have yet to be implemented. As such, users are still not encouraged to use dots and dollars in field names.

Subscribers can now be registered directly on Manager objects via Manager::addSubscriber() and removeSubscriber() methods. Subscribers registered in this manner will only receive events associated with the Manager(s) with which they are registered. The global functions can still be used to register Subscribers that will receive events for all Managers.

The Manager constructor now supports a disableClientPersistence option in its $driverOptions parameter. Specifying true for this option will prevent the PHP driver from re-using a previously persisted libmongoc client for the Manager. A new client will be created internally and will also be destroyed along with the Manager object instead of being persisted for future use within the same PHP/worker process. Disabling client persistence is not generally recommended.

The Session class now reports information about a running transaction in its debug output (e.g. var_dump()). The CursorId class now supports var_export() and __set_state().

This release upgrades our libbson and libmongoc dependencies to 1.18.0. The libmongocrypt dependency has been upgraded to 1.2.1. Support for PHP 7.0 has been removed and the extension now requires PHP 7.1 or newer.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=30261

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Installation

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

pecl install mongodb-1.10.0

or update with:

pecl upgrade mongodb-1.10.0

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

Thanks

Thanks for our community contributors for 1.10.0:

• Tanli Su

1.9.2

The PHP team is happy to announce that version 1.9.2 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes an issue with MongoDB\BSON\toPHP() rewriting memory for its $typeMap argument. The bundled version of libbson and libmongoc has also been updated to 1.17.7.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=30915

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.9.2

or update with:

pecl upgrade mongodb-1.9.2

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.10.0-alpha1

The PHP team is happy to announce that the first alpha release of version 1.10.0 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release adds support for Stable API (which will be released with MongoDB 5.0), using Azure and GCP keystores for client-side field level encryption, and a new option to disable libmongoc client persistence when creating a new MongoDB\Driver\Manager instance.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=30927

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.10.0alpha1

or update with:

pecl upgrade mongodb-1.10.0alpha1

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.9.1

The PHP team is happy to announce that version 1.9.1 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes return values for Cursor::current() and key() when the cursor's position is invalid. It also addresses an issue where the PHP version information reported in the client metadata handshake could be truncated. The bundled version of libbson and libmongoc has also been updated to 1.17.4.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=30327

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.9.1

or update with:

pecl upgrade mongodb-1.9.1

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.9.0

The PHP team is happy to announce that version 1.9.0 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release makes the extension compatible with PHP 8.

This release ensures that all functions in the extension throw MongoDB\Driver\Exception\InvalidArgumentException instead of emitting a PHP error or warning during argument parsing (e.g. E_WARNING). Previous versions of the driver generally only did this for constructors, which was inconsistent. Note that this behavior does not apply to cases where PHP throws an Error (e.g. TypeError), which is done more consistently in PHP 8 (see: Consistent Type Errors).

The MongoDB\Driver\Cursor class now implements the Iterator interface directly. This change was necessary to ensure consistent behavior across all supported PHP versions.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=29627

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.9.0

or update with:

pecl upgrade mongodb-1.9.0

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.9.0-RC1

The PHP team is happy to announce that the first release candidate for version 1.9.0 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release makes the extension compatible with PHP 8.

This release also ensures that all argument errors are correctly exposed as MongoDB\Driver\Exception\InvalidArgumentException on PHP 7. PHP 8 handles argument checks differently, so extra arguments or wrong types will trigger built-in errors.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=30258

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.9.0RC1

or update with:

pecl upgrade mongodb-1.9.0RC1

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.8.2

The PHP team is happy to announce that version 1.8.2 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes compilation issues on AIX platforms. It updates the bundled libmongoc library to 1.17.2, which includes fixes for DNS lookups when using mongodb+srv:// connection strings.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=30121

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.8.2

or update with:

pecl upgrade mongodb-1.8.2

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb

1.8.1

The PHP team is happy to announce that version 1.8.1 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes a memory leak when committing transactions. It also fixes a bug where error labels attached to write concern errors were not exposed in exceptions.

A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=29617

Documentation

Documentation is available on PHP.net:
http://php.net/set.mongodb

Feedback

We would appreciate any feedback you might have on the project:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12484&issuetype=6

Installation

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

pecl install mongodb-1.8.1

or update with:

pecl upgrade mongodb-1.8.1

Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb