Skip to content

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Apr 10, 2025

This PR contains the following updates:

Package Change Age Adoption Passing Confidence
mongodb/mongodb (source) ^1.12 -> ^1.12 || ^2.0 age adoption passing confidence

Release Notes

mongodb/mongo-php-library (mongodb/mongodb)

v2.1.1

Compare Source

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.

v2.1.0

Compare Source

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.

v2.0.0

Compare Source

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.

v1.21.2

Compare Source

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.

v1.21.1

Compare Source

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

v1.21.0

Compare Source

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.


Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

Read more information about the use of Renovate Bot within Laminas.

@renovate renovate bot added the renovate label Apr 10, 2025
@renovate renovate bot force-pushed the renovate/mongodb-mongodb-2.x branch 2 times, most recently from 08069fc to 7504522 Compare August 14, 2025 14:37
| datasource | package         | from   | to    |
| ---------- | --------------- | ------ | ----- |
| packagist  | mongodb/mongodb | 1.20.0 | 2.1.2 |


Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
@renovate renovate bot force-pushed the renovate/mongodb-mongodb-2.x branch from 7504522 to c45a885 Compare November 14, 2025 10:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants