/ /

Actualizar la versión de la librería

Overview

En esta página, aprenderá a actualizar Laravel MongoDB a una nueva versión principal. También incluye los cambios que debe realizar en su aplicación para actualizar la versión de su mapeador de objetos y documentos (ODM) sin perder funcionalidad, si corresponde.

Cómo actualizar

Antes de actualizar, realiza las siguientes acciones:

Asegúrate de que la nueva versión de la librería sea compatible con la versión de MongoDB Server a la que se conecta tu aplicación y con la versión de Laravel en la que se ejecuta tu aplicación. Ver el Compatibilidad página para esta información.
Aborda cualquier cambio disruptivo entre la versión de Laravel Integration que tu aplicación usa actualmente y la versión de actualización planificada en la sección Cambios disruptivos de esta guía.

Para actualizar la versión de su biblioteca, ejecute el siguiente comando en el directorio de su aplicación:

composer require mongodb/laravel-mongodb:4.8

Para actualizar a una versión diferente de la librería, reemplaza la información después de laravel-mongodb: con tu número de versión preferido.

Cambios radicales

Un cambio disruptivo es una modificación en una convención o comportamiento en una versión específica de la Integración de Laravel que podría impedir que su aplicación funcione como se esperaba.

Los cambios disruptivos en esta sección están categorizados según las principales versiones que los introdujeron. Al actualizar las versiones de la librería, aborda todos los cambios disruptivos entre tu versión actual y la versión planificada para la actualización.

Cambios disruptivos en la versión 4.x

Esta versión de la librería presenta los siguientes cambios disruptivos:

La versión mínima de Laravel ahora es 10.0. Para obtener instrucciones sobre cómo actualizar tu versión de Laravel, consulta la Guía de actualización en la documentación de Laravel.
El nombre de la dependencia ahora es "mongodb/laravel-mongodb". Asegúrese de que el nombre de la dependencia en su archivo composer.json sea "mongodb/laravel-mongodb": "^4.0". Luego, ejecuta composer update.
El namespace ahora es MongoDB\Laravel\. Asegúrate de cambiar el namespace de Jenssegers\Mongodb\ a MongoDB\Laravel\ en tus modelos y archivos de configuración.
Elimina el soporte para proyectos que no sean Laravel.
Elimina la compatibilidad con la propiedad $dates. Asegúrate de cambiar todas las instancias de $dates a $casts en los archivos del modelo.
Model::unset($field) no conserva el cambio. Asegúrate de que sigues todas las llamadas a Model::unset($field) con Model::save().
Elimina el método Query\Builder::whereAll($column, $values). Asegúrese de reemplazar todas las llamadas a Query\Builder::whereAll($column, $values) por Query\Builder::where($column, 'all', $values).
Query\Builder::delete() Puede eliminar uno o todos los documentos. Asegúrese de pasar solo los valores 1 o null a limit().
whereDate(), whereDay(), whereMonth(), whereYear(), y whereTime() métodos ahora utilizan operadores de MongoDB en campos de fecha.
Agrega el MongoDB\Laravel\Eloquent\MassPrunable rasgo. Asegúrate de reemplazar todas las instancias de Illuminate\Database\Eloquent\MassPrunable por MongoDB\Laravel\Eloquent\MassPrunable en tus modelos.
Remueve el soporte para los siguientes métodos de Query\Builder:
- toSql()
- toRawSql()
- whereColumn()
- whereFullText()
- groupByRaw()
- orderByRaw()
- unionAll()
- union()
- having()
- havingRaw()
- havingBetween()
- whereIntegerInRaw()
- orWhereIntegerInRaw()
- whereIntegerNotInRaw()
- orWhereIntegerNotInRaw()

Volver

Compatibilidad

Symfony Integration