1.7.2

The PHP team is happy to announce that version 1.7.2 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This release removes an unnecessary field from createIndexes commands.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.7.2

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.7.1

The PHP team is happy to announce that version 1.7.1 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This release fixes errors during PHP shutdown if GridFS streams were left open in a dirty state.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.7.1

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.7.0

The PHP team is happy to announce that version 1.7.0 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension. This release adds support for new features in MongoDB 4.4.

Release Highlights

New Client::listDatabaseNames and Database::listCollectionNames() methods allow enumeration of database and collection names without returning additional metadata. In the case of collection enumeration, this leverages the nameOnly option for listCollections and avoids taking a collection-level lock on the server.

Client::listDatabases() now supports an authorizedDatabases option, which can be used with MongoDB 4.0.5 or newer.

The Collection::deleteOne(), deleteMany(), and findOneAndDelete() methods now support a hint option to specify an index that should be used for the query. This option is also supported for delete operations in bulk writes. This option requires MongoDB 4.4 or later.

The Collection::findOneAndReplace() and findOneAndUpdate() methods now support a hint option, which requires MongoDB 4.2.

Collection::createIndex() and createIndexes() now support a commitQuorum option, which can be used with MongoDB 4.4.

The MongoDB\Operation\Aggregate class now implements the MongoDB\Operation\Explainable interface and can be used with Collection::explain(). This is an alternative to the explain option supported by Collection::aggregate() and allows for more verbose output when explaining aggregation pipelines.

The Client constructor now supports a driver option in its $driverOptions parameter, which can be used by wrapping drivers and libraries to append metadata (e.g. name and version) to the server handshake. The PHP library will also now append its own name and version to the metadata reported by the mongodb extension. Note that this feature is primarily designed for custom drivers and ODMs, which may want to identify themselves to the server for diagnostic purposes. Applications should use the appName URI option instead of driver metadata.

This release upgrades the mongodb extension requirement to 1.8.0. Support for PHP 5.6 has been removed and the library now requires PHP 7.0 or newer.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.7.0

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.7.0-rc1

The PHP team is happy to announce that version 1.7.0-rc1 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

New MongoDB\Client::listDatabaseNames and MongoDB\Database::listCollectionNames methods allow enumeration of database and collection names without returning additional metadata. In the case of collection enumeration, this leverages the nameOnly option for listCollections and avoids taking a collection-level lock on the server.

The MongoDB\Operation\Aggregate class now implements the MongoDB\Operation\Explainable interface and can be used with MongoDB\Collection::explain(). This is an alternative to the explain option supported by MongoDB\Collection::aggregate() and allows for more verbose output when explaining aggregation pipelines.

As previously announced, this version drops compatibility with PHP 5.6 and requires PHP 7.0 or newer.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.7.0@RC

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.6.1

The PHP team is happy to announce that version 1.6.1 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This release fixes a bug where the Database::command() helper incorrectly inherited a read preference from the database.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.6.1

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.7.0-beta2

The PHP team is happy to announce that version 1.7.0-beta2 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This beta release provides support for additional new features in MongoDB 4.4 following the previous 1.7.0-beta1 release.

Collection::createIndex() and createIndexes() now support a commitQuorum option, which can be used with MongoDB 4.4.

Client::listDatabases() now supports an authorizedDatabases option, which can be used with MongoDB 4.0.5 or newer.

As previously announced, this version drops compatibility with PHP 5.6 and requires PHP 7.0 or newer.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.7.0@beta

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.7.0-beta1

The PHP team is happy to announce that version 1.7.0-beta1 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This beta release provides support for new features in MongoDB 4.4.

For authentication, this release adds support for the new MONGODB-AWS authentication mechanism. The SCRAM mechanism now supports shorter conversation when authenticating with the server.

The delete command (and its helpers), delete operations in bulk writes, as well as all findAndModify operations now support specifying a hint option.

As previously announced, this version drops compatibility with PHP 5.6, limiting support to PHP 7.0 and newer.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.7.0@beta

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.6.0

The PHP team is happy to announce that version 1.6.0 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This release introduces classes and options to enable Client-Side Field Level Encryption. With this feature, sensitive data can be automatically encrypted (MongoDB Enterprise Edition only) or explicitly encrypted using the MongoDB\Driver\ClientEncryption API.

The MongoDB\Collection::updateOne, updateMany, replaceOne methods now support a hint option to specify the index that should be used for the query. The option is also supported for update operations in bulk writes. This option requires MongoDB 4.2 or later.

This release deprecates using a JavaScript instance with scope when calling MongoDB\Collection::mapReduce for the map, reduce, and finalize options. Use the scope option instead. The nonAtomic and sharded options for the $out Map-Reduce argument are also deprecated.

Please note that this is the last minor release series that is compatible with PHP 5. Support for PHP 5 will be dropped in the upcoming 1.7.0 release.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.6.0

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.5.2

The PHP team is happy to announce that version 1.5.2 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This release fixes a potential memory leak when using the MongoDB\Model\CachingIterator class and tightens validation around the chunkSizeBytes option for GridFS file uploads.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.5.2

Installation instructions for the mongodb extension may be found in the PHP.net documentation.

1.5.1

The PHP team is happy to announce that version 1.5.1 of the MongoDB PHP library is now available. This library is a high-level abstraction for the mongodb extension.

Release Highlights

This release fixes passing an aggregation pipeline to update operations in a bulk write. The distinct helper in MongoDB\Collection now also correctly inherits the collection's type map when it wasn't passed using the $options argument.

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

Documentation

Documentation for this library may be found at:
https://docs.mongodb.com/php-library/

Feedback

If you encounter any bugs or issues with this library, please report them via this form:
https://jira.mongodb.org/secure/CreateIssue.jspa?pid=12483&issuetype=1

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb^1.5.1

Installation instructions for the mongodb extension may be found in the PHP.net documentation.