1.17.3

The PHP team is happy to announce that version 1.17.3 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release updates bundled versions of libmongoc and libmongocrypt to 1.25.4 and 1.8.4, respectively.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.17.3

or update with:

pecl upgrade mongodb-1.17.3

Windows binaries are attached to the GitHub release notes.

1.17.2

The PHP team is happy to announce that version 1.17.2 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes a performance regression that was introduced in 1.17.0.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.17.2

or update with:

pecl upgrade mongodb-1.17.2

Windows binaries are attached to the GitHub release notes.

1.17.1

The PHP team is happy to announce that version 1.17.1 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release upgrades our libbson and libmongoc dependencies to 1.25.2.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.17.1

or update with:

pecl upgrade mongodb-1.17.1

Windows binaries are attached to the GitHub release notes.

1.17.0

The PHP team is happy to announce that version 1.17.0 of the mongodb PHP extension is now available on PECL. This complements the 1.17.0 library release.

Release Highlights

With this release, the driver's configure options are now defined in the PECL package. Previously, a manual build from source was required to customize the build process. Running pecl install will now prompt for input for each configure option. This behavior may be undesirable for automated installations (e.g. CI or deployment scripts), but the prompts may be overcome by either piping input into the PECL command (e.g. yes '' | pecl install) or explicitly defining each configure option via arguments to pecl install. Both approaches are discussed in the PECL install docs.

When compiling the driver with bundled libmongoc on macOS, OpenSSL is now preferred by default. Previously, Secure Transport would be used by default. This change resolves possible segfaults when running PHP-FPM on macOS.

A MongoDB\Driver\Monitoring\LogSubscriber interface was introduced, which can be used to capture driver log messages. Implementing classes can be registered using the existing MongoDB\Driver\Monitoring\addSubscriber() function. Note that log subscribers are global and cannot be registered via MongoDB\Driver\Manager::addSubscriber().

MongoDB\BSON\PackedArray and MongoDB\BSON\Document now implement ArrayAccess. Additionally, MongoDB\BSON\Document allows fields to be accessed as properties. Note that both classes are still read-only and will throw when attempting to set or unset a field.

The tentative return type of MongoDB\BSON\Serializable::bsonSerialize() was changed to allow returning either an array, stdClass, MongoDB\BSON\Document, or MongoDB\BSON\PackedArray.

This release upgrades our libbson and libmongoc dependencies to 1.25.1. Support for PHP 7.2 and 7.3 has been removed and the extension now requires PHP 7.4 or newer.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.17.0

or update with:

pecl upgrade mongodb-1.17.0

Windows binaries are attached to the GitHub release notes.

1.16.2

The PHP team is happy to announce that version 1.16.2 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes build issue on some platforms (e.g. Alpine Linux) when compiling the driver with PHP 8.2+. Additionally, it includes an upstream fix from libmongoc to address a possible deadlock when communicating with a MongoDB server that is in the process of restarting.

This release upgrades our libbson and libmongoc dependencies to 1.24.3.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.16.2

or update with:

pecl upgrade mongodb-1.16.2

Windows binaries are attached to the GitHub release notes.

1.16.1

The PHP team is happy to announce that version 1.16.1 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release fixes a missing zlib dependency when installing the package from PECL.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.16.1

or update with:

pecl upgrade mongodb-1.16.1

Windows binaries are attached to the GitHub release notes.

1.16.0

The PHP team is happy to announce that version 1.16.0 of the mongodb PHP extension is now available on PECL. This release introduces support for MongoDB 7.0.

Release Highlights

This release introduces a backwards breaking change to the Queryable Encryption protocol. Using Queryable Encryption now requires MongoDB 7.0 or later.

MongoDB\BSON\Document and MongoDB\BSON\PackedArray classes have been introduced, which represent raw BSON data for documents and arrays, respectively. These classes can be instantiated via factory methods or by specifying bson in a type map. Iterating a Document or PackedArray will yield a MongoDB\BSON\Iterator object.

Several improvements were made to MongoDB\BSON\Int64. The class constructor has been made public and Int64 objects now support casting, comparison, and arithmetic operations. Int64 objects always encode as a 64-bit integer in BSON, so this change will allow applications more control over BSON encoding. There is no change to the driver's default BSON decoding behavior; however, the new Document and PackedArray classes will always return 64-bit BSON integers as Int64 objects.

This release upgrades our libbson and libmongoc dependencies to 1.24.1. The libmongocrypt dependency has been upgraded to 1.8.1.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.16.0

or update with:

pecl upgrade mongodb-1.16.0

Windows binaries are attached to the GitHub release notes.

1.15.3

The PHP team is happy to announce that version 1.15.3 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release upgrades our libbson and libmongoc dependencies to 1.23.4, which fixes an issue with MONGODB-X509 authentication after a network error.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.15.3

or update with:

pecl upgrade mongodb-1.15.3

Windows binaries are attached to the GitHub release notes.

1.15.2

The PHP team is happy to announce that version 1.15.2 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release upgrades our libbson and libmongoc dependencies to 1.23.3.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.15.2

or update with:

pecl upgrade mongodb-1.15.2

Windows binaries are attached to the GitHub release notes.

1.15.1

The PHP team is happy to announce that version 1.15.1 of the mongodb PHP extension is now available on PECL.

Release Highlights

This release updates libmongoc to 1.23.2 and fixes a potential null pointer access when encountering a write concern error without an error message. It also ensures that Windows DLLs are built for all supported PHP versions.

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

Documentation

Documentation is available on PHP.net.

Installation

You can either download and install the source manually, or you can install the extension with:

pecl install mongodb-1.15.1

or update with:

pecl upgrade mongodb-1.15.1

Windows binaries are attached to the GitHub release notes.