Releases: mongodb/mongo-php-driver
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:
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
jmikola
Jeremy Mikola
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:
1.12.1
The PHP team is happy to announce that version 1.12.1 of the mongodb PHP extension is now available on PECL.
Release Highlights
This release upgrades our libbson and libmongoc dependencies to 1.20.1, which fixes a bug related to Atlas Serverless connections.
A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=32724
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.12.1
or update with:
pecl upgrade mongodb-1.12.1
Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb
1.12.0
The PHP team is happy to announce that version 1.12.0 of the mongodb PHP extension is now available on PECL.
Release Highlights
Building upon work done in the previous 1.11.0 release, this release completes compatibility with PHP 8.1.0. Classes with __toString() methods now specify a string return type and implement Stringable for PHP 8.0+. Interfaces with __toString() methods now specify tentative return type info.
This release adds support for KMIP keystores when using client-side field level encryption. Additionally, TLS options may now be specified when configuring a keystore. These improvements apply to both the autoEncryption driver option for MongoDB\Driver\Manager::__construct() and
Manager::createClientEncryption() method.
This release upgrades our libbson and libmongoc dependencies to 1.20.0. The libmongocrypt dependency has been upgraded to 1.3.0. Support for PHP 7.1 has been removed and the extension now requires PHP 7.2 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=31694
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.12.0
or update with:
pecl upgrade mongodb-1.12.0
Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb
1.11.1
The PHP team is happy to announce that version 1.11.1 of the mongodb PHP extension is now available on PECL.
Release Highlights
This release fixes a package requirement when libmongoc is used as a system library.
A complete list of resolved issues in this release may be found at: https://jira.mongodb.org/secure/ReleaseNote.jspa?projectId=12484&version=32003
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.1
or update with:
pecl upgrade mongodb-1.11.1
Windows binaries are available on PECL:
http://pecl.php.net/package/mongodb