Overview
En esta guía, aprenderá sobre los cambios que debe realizar en su aplicación al actualizar a una nueva versión de la biblioteca PHP de MongoDB. Esta página también describe cómo actualizar su extensión PHP a una nueva versión.
Cómo actualizar
Antes de actualizar, realice las siguientes acciones:
Aborde cualquier cambio importante entre la versión de la biblioteca que utiliza su aplicación y la versión de actualización planificada en el Secciónde cambios importantes.
Asegúrese de que la nueva versión de la biblioteca PHP sea compatible con las versiones de MongoDB Server a las que se conecta su aplicación y con la versión de PHP con la que compila. Para obtener información sobre la compatibilidad de versiones, consulte la sección "Cambios de compatibilidad" y la página "Compatibilidad".
Tip
Para garantizar la compatibilidad entre las versiones de MongoDB Server al actualizar las versiones de la biblioteca, utilice el API estable.
Las versiones principales y secundarias de la extensión y la biblioteca de PHP están sincronizadas. Esto significa que puedes ejecutar un comando de actualización para que la extensión también actualice la biblioteca de PHP.
Las versiones de parche (xxx) de la biblioteca y la extensión no están sincronizadas. Ejecute los comandos correspondientes para actualizar a las versiones de parche de la biblioteca o la extensión.
Para actualizar la extensión PHP, reemplace <version-number> con el número de versión a la que desea actualizar y ejecute el siguiente comando en el directorio de su aplicación:
pie install mongodb/mongodb-extension:^<version-number>
Tip
Versiones anteriores de la extensión PHP
Para actualizar a una versión de extensión PHP anterior a la v1.21, utilice el siguiente comando:
pecl upgrade mongodb-<version-number>
Para actualizar la versión de la biblioteca PHP, reemplace <version-number> con el número de versión a la que desea actualizar y ejecute el siguiente comando en el directorio de su aplicación:
composer require mongodb/mongodb:<version-number>
Las instrucciones de instalación detalladas se pueden encontrar en la documentación de PHP.net.
Cambios radicales
Un cambio disruptivo es un cambio en una convención o comportamiento que se inicia en una versión específica de la biblioteca. Este tipo de cambio puede impedir el correcto funcionamiento de la aplicación si no se soluciona antes de actualizar la biblioteca.
Los cambios importantes de esta sección se clasifican según la versión de la biblioteca que los introdujo. Solo las versiones principales de la biblioteca introducen cambios importantes. Al actualizar versiones, aborde todos los cambios importantes entre la versión actual y la versión de actualización.
Para obtener más información sobre los cambios de versión, consulte las notas de la versión y los tickets de JIRA asociados para cada versión en GitHub.
Cambios importantes en la versión 2.0
Esta versión de la biblioteca introduce los siguientes cambios importantes:
Los siguientes métodos devuelven
voiden lugar de la respuesta del comando sin procesar:MongoDB\\Client:dropDatabase()MongoDB\\Collection:drop(),dropIndex(),dropIndexes(),dropSearchIndex(),rename()MongoDB\\Database:createCollection(),drop(),dropCollection(),renameCollection()
El método
MongoDB\\Database::createEncryptedCollection()devuelve la lista de campos cifrados en lugar de la respuesta del comando sin procesar.Si hay un error, los métodos lanzan una excepción.
Si necesita acceder a la respuesta del comando sin procesar de los métodos anteriores, puede registrar un CommandSubscriber en su aplicación.
Cambios de compatibilidad
Esta sección describe los cambios de compatibilidad entre MongoDB Server y PHP introducidos en las nuevas versiones de la biblioteca PHP de MongoDB.
Versión 1.x Cambios de compatibilidad
Esta versión de la biblioteca introduce los siguientes cambios de compatibilidad:
Se elimina la compatibilidad con MongoDB Server 3.6 en la biblioteca PHP MongoDB v1.20
Tip
Versiones anteriores de la biblioteca
Para ver los cambios de compatibilidad para las versiones y anteriores de la biblioteca PHP 1.19 de MongoDB, consulte las notas de la versión y los tickets de JIRA asociados para cada versión en GitHub.