Skip to content

2.0.0

Choose a tag to compare

View all tags
@mongodb-dbx-release-bot mongodb-dbx-release-bot released this 10 Apr 08:38
· 20 commits to v2.0 since this release
2.0.0
04cd7ed
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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.

Assets 3
Loading