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, realice las siguientes acciones:
Asegúrese de que la nueva versión de la biblioteca sea compatible con la versión del servidor MongoDB a la que se conecta su aplicación y con la versión de Laravel en la que se ejecuta. Consulte Página de compatibilidad para esta información.
Aborde cualquier cambio importante entre la versión de la integración de Laravel que su aplicación utiliza actualmente y la versión de actualización planificada en la sección Cambios importantes 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 biblioteca, reemplace la información después
laravel-mongodb: con su número de versión preferido.
Cambios radicales
Un cambio importante 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 espera.
Los cambios importantes de esta sección se clasifican según las versiones principales que los introdujeron. Al actualizar las versiones de la biblioteca, tenga en cuenta todos los cambios importantes entre su versión actual y la versión de actualización prevista.
Cambios disruptivos en la versión 4.x
Esta versión de la biblioteca introduce los siguientes cambios importantes:
La versión mínima de Laravel ahora 10.0 es. 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 archivocomposer.jsonsea"mongodb/laravel-mongodb": "^4.0". Luego, ejecutecomposer update.El espacio de nombres ahora es
MongoDB\Laravel\. Asegúrate de cambiar el espacio de nombres deJenssegers\Mongodb\aMongoDB\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$datesa$castsen los archivos del modelo.Model::unset($field)No persiste el cambio. Asegúrese de seguir todas las llamadas aModel::unset($field)conModel::save().Elimina el método
Query\Builder::whereAll($column, $values). Asegúrate de reemplazar todas las llamadas aQuery\Builder::whereAll($column, $values)porQuery\Builder::where($column, 'all', $values).Query\Builder::delete()Puede eliminar uno o todos los documentos. Asegúrese de pasar solo los valores1onullalimit().whereDate()Los métodoswhereDay(),whereMonth(),whereYear()ywhereTime()ahora utilizan operadores MongoDB en los campos de fecha.Añade el atributo
MongoDB\Laravel\Eloquent\MassPrunable. Asegúrate de reemplazar todas las instancias deIlluminate\Database\Eloquent\MassPrunableporMongoDB\Laravel\Eloquent\MassPrunableen tus modelos.Elimina la compatibilidad con los siguientes métodos
Query\Builder:toSql()toRawSql()whereColumn()whereFullText()groupByRaw()orderByRaw()unionAll()union()having()havingRaw()havingBetween()whereIntegerInRaw()orWhereIntegerInRaw()whereIntegerNotInRaw()orWhereIntegerNotInRaw()