Skip to content

1.21.0

Choose a tag to compare

View all tags
@mongodb-dbx-release-bot mongodb-dbx-release-bot released this 28 Feb 13:04
· 20 commits to v1.21 since this release
1.21.0
d216a5b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

Assets 3
Loading