2.1.1

The PHP team is happy to announce that version 2.1.1 of the MongoDB PHP library is now available.

Release Highlights

This version fixes the deletion of metadata collections when automatic encryption is enabled.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:2.1.1

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

1.21.2

The PHP team is happy to announce that version 1.21.2 of the MongoDB PHP library is now available.

Release Highlights

This version fixes the deletion of metadata collections when automatic encryption is enabled.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.21.2

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

2.1.0

The PHP team is happy to announce that version 2.1.0 of the MongoDB PHP library is now available.

Release Highlights

This release introduces the new Client::bulkWrite() method using the bulkWrite command added in MongoDB 8.0 and supported by mongodb extension v2.1.0. Support for MongoDB 4.0 has been removed.

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

Documentation

Documentation for this library may be found in the PHP Library Manual, including the new Client Bulk Write.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:2.1.0

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

2.0.0

The PHP team is happy to announce that version 2.0.0 of the MongoDB PHP library is now available.

Release Highlights

• PHP Driver Major Release 2.0: This is a major release that introduces numerous changes and improvements across the library.
• Aggregation Builder Enhancement: Now allows passing an Aggregation Builder Pipeline directly to the aggregate method.
• Cursor Interface: Replaced the Cursor type hints with CursorInterface for better extensibility and compatibility.
• Removed Deprecated Methods: Methods and constants have been removed, ensuring cleaner and more streamlined code.

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

New Features and Enhancements

• Aggregation Builder: The aggregate method now supports passing an aggregation builder Pipeline for more flexible and readable queries. (PHPLIB-1617).
• Cursor Interface: Type hints for cursor-related functionality have been replaced by CursorInterface to allow more flexibility for custom cursor implementations. (PHPLIB-1114).

Deprecated and Removed Features

• GridFS Deprecated Fields: GridFS fields (md5, contentType, aliases) have been removed, which may affect older implementations. (PHPLIB-1218).
• Removed Watch::FULL_DOCUMENT_DEFAULT Constant: The FULL_DOCUMENT_DEFAULT constant in Watch has been removed (PHPLIB-818).
• Deprecated Find Options Removed: Various deprecated Find options have been removed as part of streamlining the API (PHPLIB-1511).
• Removal of mapReduce Helper: The mapReduce helper has been removed from Collection due to its deprecation in favor of other aggregation methods (PHPLIB-1513).
• Removal of autoIndexId Option: The autoIndexId option has been removed from CreateCollection, simplifying collection creation (PHPLIB-1159).

Compatibility Updates

• MongoDB Extension 2.0: This release requires MongoDB extension version 2.0.0 or higher.
• PHP 8.1+ Required: The minimum required PHP version is now 8.1, as support for older versions (PHP 7.4 and 8.0) has been dropped.
• MongoDB 4.2+ Required: Future versions of the library will require MongoDB 4.2 or later. MongoDB 4.0 support is deprecated.

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:2.0.0

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

1.21.1

The PHP team is happy to announce that version 1.21.1 of the MongoDB PHP library is now available.

Release Highlights

Remove dependency to extensions and PHP polyfill packages that are always available in PHP 8.1+.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.21.1

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

Learn more about the aggregation builder here: Better Aggregation Pipeline Support in the MongoDB PHP Driver

1.21.0

The MongoDB team is pleased to announce the release of version 1.21.0 of the MongoDB PHP Library.

This release introduces new features, enhancements, and deprecations in preparation for future improvements. It requires version 1.21.0 of the mongodb PHP extension, and PHP 8.1 or later.

New Features and Enhancements

• Aggregation Builder: Introduces the builder framework to simplify writing aggregation pipelines and query filters.
• Added support for the sort option in replaceOne and updateOne operations was added to better control which documents get updated
• Method name changes: selectDatabase() and selectCollection methods are renamed to getDatabase and getCollection. The old names are deprecated and will be released in 3.0 to give projects ample time to update.
• GridFS helpers: Introduces new methods deleteByName($filename) and renameByName($filename, $newFilename) to modify all the revisions of a file by its name.
• When using array access on MongoDB\BSON\Document instances, integers are now accepted to access numeric keys in a BSON document
• Distinct index: The hint option is now supported in distinct queries, improving index utilization.

Deprecations

In this release, we also deprecated a number of features in preparation for an upcoming 2.0 release:

• Returned value of database and collection operations without meaningful result is deprecated. The typeMap option is deprecated when creating a collection or when dropping collections, databases and indexes.
• Negative limit Values: Passing negative values for the limit option in queries is deprecated. Instead, use the singleBatch option.
• Write Concern and Read Preference Changes: Passing WriteConcern or ReadPreference instances to command execution methods is deprecated. Use the writeConcern and readPreference options instead.
• Float Arguments in UTCDateTime: Constructing MongoDB\BSON\UTCDateTime with a float argument is now deprecated.

Fixed bugs

• In Find operation, ensure no cursor is left behind when limit == batchSize

Compatibility Updates

• MongoDB Extension 1.21: This release requires to update the mongodb extension to the version 1.21
• PHP 8.1 Required: Support for PHP 7.4 and 8.0 has been dropped. The minimum required version is now PHP 8.1.
• Support for MongoDB 4.0 Deprecated: Future versions will require MongoDB 4.2 or later.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.21.0

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

1.20.0

The PHP team is happy to announce that version 1.20.0 of the MongoDB PHP library is now available.

Release Highlights

The PHP team is happy to announce that version 1.20.0 of the MongoDB PHP library is now available. This release introduces support for MongoDB 8.0.

Release Highlights

This release adds support for Queryable Encryption Range Queries when using MongoDB 8.0.

This release drops support for MongoDB 3.6. A future release will drop support for PHP 7.4 and 8.0.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.20.0

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

1.19.1

The PHP team is happy to announce that version 1.19.1 of the MongoDB PHP library is now available.

Release Highlights

This version contains no user-facing changes but was made for internal compliance reasons.

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.19.1

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

1.19.0

The PHP team is happy to announce that version 1.19.0 of the MongoDB PHP library is now available.

Release Highlights

This release contains no significant changes and was done to keep version parity with the MongoDB extension. Please note that a future minor release plans to raise the minimum supported MongoDB Server version from 3.6 to 4.0. This is in accordance with MongoDB Software Lifecycle Schedules.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.19.0

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

1.18.0

The PHP team is happy to announce that version 1.18.0 of of the MongoDB PHP library is now available. This complements the 1.18.0 extension release.

Release Highlights

This release introduces 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 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.

The MongoDB\Client class now has addSubscriber() and removeSubscriber() methods to make it easier to register monitoring classes on the underlying MongoDB\Driver\Manager object.

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

Documentation

Documentation for this library may be found in the PHP Library Manual.

Installation

This library may be installed or upgraded with:

composer require mongodb/mongodb:1.19.0

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