/ /

Notas de versión

Conozca las nuevas funcionalidades, mejoras y correcciones introducidas en las siguientes versiones de la MongoDB PHP librería:

Novedades en 1.21.5

La versión v1.21.5 de la biblioteca PHP incluye el siguiente cambio:

Importante

La biblioteca PHP v1.21.5 incluye una corrección para CVE-202688023-.

For the latest information about MongoDB security updates, see MongoDB Security Bulletins.

Para obtener una lista completa de los cambios en esta versión, consulte las notas de la versión121v..5 en GitHub.

The PHP library v1.21.4 release includes the following change:

Importante

PHP library v1.21.4 includes a fix for CVE-2026-81525.

For the latest information about MongoDB security updates, see MongoDB Security Bulletins.

Para obtener una lista completa de los cambios en esta versión, consulte las notas de la versión121v..4 en GitHub.

El lanzamiento de la librería PHP v1.21 incluye las siguientes funcionalidades, mejoras y correcciones:

Presenta el Aggregation Builder, una API para crear pipelines de agregación de manera más segura en cuanto a tipos. Para obtener más información y ver ejemplos, consulte la sección Constructor de Agregación de la Guía de Agregación.
Agrega los siguientes métodos:
Los métodos Client::selectCollection(), Client::selectDatabase() y Database::selectCollection() quedarán obsoletos y serán reemplazados por estos nuevos métodos en una futura versión de driver, por lo tanto, considera cambiar su uso en tu aplicación.
Agrega argumentos con nombre para SearchStage, VectorSearchStage y SearchMetaStage clases constructoras. Este cambio permite escribir consultas de MongoDB Search y MongoDB Vector Search de una manera más segura en cuanto a tipos y organizada. Para saber más, consulta las guías Ejecutar una MongoDB Search Query y Ejecutar una MongoDB Vector Search Query.
Depreca la opción flags, usada para el motor de almacenamiento MMAPv1 obsoleto. Esta opción se eliminará en la librería de PHP v2.0.
Agrega una opción para ordenar a los métodos MongoDB\Collection::updateOne() y MongoDB\Collection::replaceOne(). Este cambio también te permite definir un orden de clasificación como opción al realizar operaciones de actualización y reemplazo en una operación masiva.
Agrega la opción builderEncoder a los siguientes métodos:

Para obtener más información sobre los cambios en esta versión, consulte las notas de1 la versión21 v. en GitHub.

Importante

MongoDB Server v3.6 Fin de vida

Se eliminó la compatibilidad con MongoDB Server v3.6 en esta versión de la librería.

Agrega soporte para MongoDB Server v8.0.
Agrega soporte para consultas de rango encriptadas consultables (Queryable Encryption). Para utilizar esta funcionalidad, tu aplicación debe conectarse a MongoDB Server 8.0 o posterior. Para obtener más información sobre las consultas de rango QE, consulta Queryable Encryption en el manual de MongoDB Server.
Cuando una operación de un clúster no tiene éxito, la librería evita seleccionar el mismo servidor de mongos para los intentos de reintento de la operación si hay otros servidores de mongos disponibles.
Cuando crea una clave de datos KMIP, ahora puede especificar la opción delegated. Si esta opción se configura en true, el proveedor KMIP realiza el cifrado y descifrado de la clave de datos localmente, asegurando que la clave de cifrado nunca abandone el servidor KMIP.
Agrega la opción type en las especificaciones del índice de búsqueda para los métodos MongoDB\Collection::createIndex() y MongoDB\Collection::createSearchIndexes(). Este cambio permite crear índices de MongoDB Vector Search de forma programática. Para aprender más y ver ejemplos, consulta la guía Índices de búsqueda de MongoDB.

Para obtener más información sobre los cambios en esta versión, consulte las notas de1 la versión20 v. en GitHub.

Esta versión de la librería PHP no contiene cambios significativos y se añadió para mantener la paridad de versiones con la extensión de PHP.

Agrega una nueva API de GridFS para facilitar el trabajo con archivos utilizando las funciones existentes del sistema de archivos de PHP. El método MongoDB\GridFS\Bucket::registerGlobalStreamWrapperAlias() puede utilizarse para registrar un alias global para un `GridFS bucket`. Después de hacer esto, los archivos dentro de ese bucket pueden accederse utilizando solo un URI de archivo (por ejemplo, "gridfs://mybucket/hello.txt"). Se puede encontrar una demostración de esta API en el script de ejemplo gridfs_stream_wrapper.php.
Agrega los métodos MongoDB\Client::addSubscriber() y MongoDB\Client::removeSubscriber() a la clase MongoDB\Client para facilitar la registración de clases de supervisión circunscritas al objeto subyacente MongoDB\Driver\Manager.

Para obtener más información sobre esta versión, consulte las 118 notas de la versión v. en GitHub.

Introduce una nueva API "codec" para convertir BSON hacia y desde objetos PHP. Se puede encontrar más información sobre esta funcionalidad en el tutorial de Codecs.
Agrega las MongoDB\add_logger() funciones y a la biblioteca. Estas funciones MongoDB\remove_logger() permiten que las3 aplicaciones registren un registrador PSR- para recibir los mensajes de registro emitidos por el controlador. Anteriormente, los registros solo estaban disponibles a través de la configuración mongodb.debug de la INI extensión.
Introduce los nuevos métodos MongoDB\Collection para crear y gestionar índices de MongoDB Search. Los índices de búsqueda de MongoDB Search se pueden consultar utilizando la etapa de pipeline de agregación $search, la cual es compatible con todas las versiones de la librería. Para obtener más información sobre los índices de MongoDB Search y los detalles de la etapa de agregación $search, consulta la documentación de Índices de MongoDB Search y $search.
Actualiza el requisito de extensión de mongodb a 1.17.0. La compatibilidad con PHP 7.2 y 7.3 se ha eliminado y la librería ahora requiere PHP 7.4 o una versión más reciente.

Para obtener más información sobre esta versión, consulte las 117 notas de la versión v. en GitHub.