Actualizar versiones de librerías

Overview

En esta página, puedes aprender sobre los cambios que se deben realizar en la aplicación al actualizar a una nueva versión de la librería PHP de MongoDB. Esta página también incluye cómo actualizar tu extensión de PHP a una nueva versión.

Cómo actualizar

Antes de actualizar, realiza las siguientes acciones:

• Aborda cualquier cambio disruptivo entre la versión de la librería que tu aplicación está usando y la versión de actualización planificada en la cambio disruptivo section.

• Asegúrate de que la nueva versión de la librería PHP sea compatible con las versiones del Servidor de MongoDB a las que tu aplicación se conecta y con la versión de PHP con la que tu aplicación compila. Para información sobre compatibilidad de versiones, consulta la sección Cambios de compatibilidad y la página Compatibilidad.

Las versiones mayor y menor de la extensión y la librería de PHP están sincronizadas. Esto significa que puedes ejecutar un comando de actualización para la extensión y también para actualizar la librería de PHP.

Las versiones de parche (x.x.x) para la librería y la extensión no están sincronizadas. Ejecuta los comandos respectivos para actualizar a las versiones parches de la librería o extensión.

Para actualizar la extensión de PHP, reemplace <version-number> con el número de versión al que quieres actualizar y ejecuta el siguiente comando en el directorio de tu aplicación:

pie install mongodb/mongodb-extension:^<version-number>

pecl upgrade mongodb-<version-number>

Para actualizar la versión de la librería PHP, reemplace <version-number> con el número de versión al que desea actualizar y ejecute el siguiente comando en el directorio de su aplicación:

composer require mongodb/mongodb:<version-number>

Pueden encontrarse instrucciones detalladas de instalación en la documentación de PHP.net.

cambio disruptivo

Un cambio disruptivo es una modificación de una convención o comportamiento que comienza en una versión específica de la librería. Este tipo de cambio puede evitar que la aplicación funcione correctamente si no se soluciona antes de actualizar la librería.

Los cambios disruptivos en esta sección se categorizan según la versión de la librería que los introdujo. Solo las versiones principales de las librerías introducen cambios disruptivos. Al actualizar versiones, se deben abordar todos los cambios disruptivos entre la versión actual y la actualizada.

Para obtener más información sobre los cambios de versión, consulta las notas de versión y los tickets de JIRA asociados para cada versión en GitHub.

Cambios de compatibilidad

Esta sección describe los cambios de compatibilidad entre el MongoDB Server y PHP introducidos en las versiones de la MongoDB PHP librería.