1.16.0

The PHP team is happy to announce that version 1.16.0 of the mongodb PHP extension is now available on PECL. This release introduces support for MongoDB 7.0.

Release Highlights

This release introduces a backwards breaking change to the Queryable Encryption protocol. Using Queryable Encryption now requires MongoDB 7.0 or later.

MongoDB\BSON\Document and MongoDB\BSON\PackedArray classes have been introduced, which represent raw BSON data for documents and arrays, respectively. These classes can be instantiated via factory methods or by specifying bson in a type map. Iterating a Document or PackedArray will yield a MongoDB\BSON\Iterator object.

Several improvements were made to MongoDB\BSON\Int64. The class constructor has been made public and Int64 objects now support casting, comparison, and arithmetic operations. Int64 objects always encode as a 64-bit integer in BSON, so this change will allow applications more control over BSON encoding. There is no change to the driver's default BSON decoding behavior; however, the new Document and PackedArray classes will always return 64-bit BSON integers as Int64 objects.

This release upgrades our libbson and libmongoc dependencies to 1.24.1. The libmongocrypt dependency has been upgraded to 1.8.1.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.16.0

or update with:

pecl upgrade mongodb-1.16.0

Windows binaries are attached to the GitHub release notes.

1.15.3

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

Release Highlights

This release upgrades our libbson and libmongoc dependencies to 1.23.4, which fixes an issue with MONGODB-X509 authentication after a network error.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.15.3

or update with:

pecl upgrade mongodb-1.15.3

Windows binaries are attached to the GitHub release notes.

1.15.2

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

Release Highlights

This release upgrades our libbson and libmongoc dependencies to 1.23.3.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.15.2

or update with:

pecl upgrade mongodb-1.15.2

Windows binaries are attached to the GitHub release notes.

1.15.1

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

Release Highlights

This release updates libmongoc to 1.23.2 and fixes a potential null pointer access when encountering a write concern error without an error message. It also ensures that Windows DLLs are built for all supported PHP versions.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.15.1

or update with:

pecl upgrade mongodb-1.15.1

Windows binaries are attached to the GitHub release notes.

1.15.0

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

Release Highlights

Tentative return types have been added to interfaces throughout the extension. Applications that cannot declare a compatible return type in their implementations will need to specify a ReturnTypeWillChange attribute on each method in order to silence deprecation notices on PHP 8.1+.

This release adds several new methods to MongoDB\Driver\ClientEncryption, which facilitate key management operations on the key vault collection. These methods mirror the existing APIs found in the MongoDB shell.

Backed enumerations are now supported during BSON encoding and will serialize as their case value. Round-tripping a backed enum through BSON will require special handling (e.g. converting the value to a case using BackedEnum::from()). Pure enums, which have no backed cases, cannot be directly serialized. Enums are prohibited from implementing MongoDB\BSON\Unserializable and MongoDB\BSON\Persistable, but may implement MongoDB\BSON\Serializable.

MongoDB\BSON\Binary::__construct() no longer requires a $type parameter and will default to Binary::TYPE_GENERIC.

This release upgrades our libbson and libmongoc dependencies to 1.23.1. The libmongocrypt dependency has been upgraded to 1.5.2.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.15.0

or update with:

pecl upgrade mongodb-1.15.0

Windows binaries are attached to the GitHub release notes.

Thanks

Thanks to our community contributors for 1.15.0:

• Remi Collet

1.14.2

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

Release Highlights

This release fixes a build issue where libresolv was not correctly linked on some platforms (e.g. Ubuntu 22.04).

This release upgrades our libbson and libmongoc dependencies to 1.22.2. This notably fixes a build issue on Alpine Linux and a separate bug that prevented the driver from connecting to Atlas Data Lake, both of which were introduced in libmongoc 1.22.0 (i.e. ext-mongodb 1.14.0).

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.14.2

or update with:

pecl upgrade mongodb-1.14.2

1.14.1

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

Release Highlights

This release upgrades our libbson and libmongoc dependencies to 1.22.1. The libmongocrypt dependency has been upgraded to 1.5.2.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.14.1

or update with:

pecl upgrade mongodb-1.14.1

Windows binaries are available on PECL.

1.14.0

The PHP team is happy to announce that version 1.14.0 of the mongodb PHP extension is now available on PECL. This release introduces support for MongoDB 6.0 and Queryable Encryption.

Release Highlights

To support Queryable Encryption, encryptedFieldsMap and bypassQueryAnalysis auto encryption options have been added to MongoDB\Driver\Manager::__construct(). Additionally, new algorithms and a queryType option have been added to MongoDB\Driver\ClientEncryption::encrypt(). Support for the Automatic Encryption Shared Library, an alternative to mongocryptd, has also been introduced.

MongoDB\Driver\BulkWrite and MongoDB\Driver\Query support a let option for defining variables that can be accessed within query filters and updates. Additionally, both classes now support a comment option of any type (previously a string comment was only supported for queries).

This release upgrades our libbson and libmongoc dependencies to 1.22.0. The libmongocrypt dependency has been upgraded to 1.5.0.

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

Documentation

Documentation is available on PHP.net.

Installation

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

pecl install mongodb-1.14.0

or update with:

pecl upgrade mongodb-1.14.0

Windows binaries are available on PECL.

1.14.0beta1

The PHP team is happy to announce that version 1.14.0beta1 of the mongodb PHP extension is now available on PECL. This release introduces support for MongoDB 6.0 and Queryable Encryption.

Release Highlights

To support Queryable Encryption, encryptedFieldsMap and bypassQueryAnalysis auto encryption options have been added to MongoDB\Driver\Manager::__construct(). Additionally, new algorithms and a queryType option have been added to MongoDB\Driver\ClientEncryption::encrypt().

MongoDB\Driver\BulkWrite and MongoDB\Driver\Query support a let option for defining variables that can be accessed within query filters and updates. Additionally, both classes now support a comment option of any type (previously a string comment was only supported for queries).

This release upgrades our libbson and libmongoc dependencies to 1.22.0-beta0. The libmongocrypt dependency has been upgraded to 1.5.0-rc1.

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

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.14.0beta1

or update with:

pecl upgrade mongodb-1.14.0beta1

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

1.13.0

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

Release Highlights

MongoDB\Driver\Manager::__construct() supports two new URI options: srvMaxHosts and srvServiceName. srvMaxHosts may be used with sharded clusters to limit the number of hosts that will be added to a seed list following the initial SRV lookup. srvServiceName may be used with self-managed deployments to customize the default service name (i.e. "mongodb").

This release introduces support for SDAM Monitoring, which applications can use to monitor internal driver behavior for server discovery and monitoring. Similar to the existing command monitoring API, applications can implement the MongoDB\Driver\Monitoring\SDAMSubscriber interface and registering the subscriber globally or for a single Manager using MongoDB\Driver\Monitoring\addSubscriber() or MongoDB\Driver\Manager::addSubscriber, respectively. In addition to many new event classes, this feature introduces the ServerDescription and TopologyDescription classes.

This release upgrades our libbson and libmongoc dependencies to 1.21.1. The libmongocrypt dependency has been upgraded to 1.3.2. Support for MongoDB 3.4 and earlier has been removed.

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

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.13.0

or update with:

pecl upgrade mongodb-1.13.0

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

Thanks

Thanks for our community contributors for 1.13.0:

• Tanli Su