What's New

What's New in 1.20

• Adds support for MongoDB Server v8.0.

• Adds support for Queryable Encryption (QE) range queries. To use this feature, your app must connect to MongoDB Server 8.0 or later. For more information about QE range queries, see Queryable Encryption in the MongoDB Server manual.

• When a sharded cluster operation is unsuccessful, the library avoids selecting the same mongos server for operation retry attempts if other mongos servers are available.

• When you create a KMIP data key, you can now specify the delegated option. If this option is set to true, the KMIP provider performs encryption and decryption of the data key locally, ensuring that the encryption key never leaves the KMIP server.

For more information about the changes in this version, see the v1.20 release notes on GitHub.

What's New in 1.19

This release of the PHP library contains no significant changes and was added to keep version parity with the PHP extension.

What's New in 1.18

• Adds a new GridFS API to make it more convenient to work with files using PHP's existing filesystem functions. The MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias() method may be used to register a global alias for a GridFS bucket. After doing so, files within that bucket can be accessed by using only a file URI (e.g. "gridfs://mybucket/hello.txt"). A demonstration of this API can be found in the gridfs_stream_wrapper.php example script.

• Adds MongoDB\Client::addSubscriber() and MongoDB\Client::removeSubscriber() methods to the MongoDB\Client class to make it easier to register monitoring classes scoped to the underlying MongoDB\Driver\Manager object.

To learn more about this release, see the v1.18 Release Notes on GitHub.

What's New in 1.17

• Introduces a new "codec" API for converting BSON to and from PHP objects. More information on this feature may be found in the Codecs tutorial.

• Adds MongoDB\add_logger() and MongoDB\remove_logger() functions to the library. These functions allow applications to register a PSR-3 Logger to receive log messages emitted by the driver. Previously, logs were only available through the extension's mongodb.debug INI setting.

• Introduces new MongoDB\Collection methods to create and manage Atlas Search indexes. Atlas Search indexes can be queried using the $search aggregation pipeline stage, which is supported in all versions of the library. To learn more about Atlas Search indexes and the specifics of the $search aggregation stage, see the Atlas Search indexes documentation and $search.

• Upgrades the mongodb extension requirement to 1.17.0. Support for PHP 7.2 and 7.3 has been removed and the library now requires PHP 7.4 or newer.

To learn more about this release, see the v1.17 Release Notes on GitHub.

What's New in 1.16

• Introduces support for MongoDB 7.0.

• Introduces MongoDB\Database::createEncryptedCollection(). This method automatically creates data encryption keys when creating a new encrypted collection.

• Upgrades the mongodb extension requirement to 1.16.0.

To learn more about this release, see the v1.16 Release Notes on GitHub.

What's New in 1.15

• Adds new examples/ and tools/ directories to the library repository, which contain code snippets and scripts that may prove useful when writing or debugging applications. These directories are intended to supplement the library's existing documentation and will be added to over time.

• Adds various backwards compatible typing improvements throughout the library. Downstream impact for these changes are discussed in UPGRADE-1.15.md.

• Integrates Psalm for static analysis.

• Upgrades the mongodb extension requirement to 1.15.0.

To learn more about this release, see the v1.15 Release Notes on GitHub.