Actualizar la versión de la biblioteca

El generador de consultas devuelve los resultados como objetos stdClass en lugar de matrices. Este cambio requiere que se cambie el acceso a la matriz por el acceso a la propiedad al interactuar con los resultados de la consulta.

El siguiente código muestra cómo recuperar un resultado de query y acceder a una propiedad del objeto resultado en versiones antiguas en comparación con la v5.0:

$document = DB::table('accounts')
    ->where('name', 'Anita Charles')
    ->first();
// older versions
$document['balance'];
// v5.0
$document->balance;

Elimina el soporte para las siguientes clases:

• MongoDB\Laravel\Auth\DatabaseTokenRepository. En cambio, utiliza la clase Illuminate\Queue\Failed\DatabaseFailedJobProvider por defecto y especifica una conexión a MongoDB.

• MongoDB\Laravel\Queue\Failed\MongoFailedJobProvider. En cambio, utiliza la clase Illuminate\Queue\Failed\DatabaseFailedJobProvider por defecto y especifica una conexión a MongoDB.

Al usar un objeto DateTimeInterface, incluido Carbon, en una consulta, la biblioteca convierte el objeto DateTimeInterface en un objeto MongoDB\BSON\UTCDateTime. Esta conversión se aplica a los objetos DateTimeInterface que se pasan como filtros de consulta al método where() o como datos que se pasan a los métodos insert() y update().

Para ver un ejemplo que pasa un objeto Carbon al método DB::where(), consulte la Sección de ejemplo defechas de coincidencia de la guía del Generador de consultas.

En los resultados de la query, la librería convierte los objetos BSON UTCDateTime a clases de fecha Carbon, aplicando la zona horaria por defecto.

En v5.1, la biblioteca también realiza esta conversión a los resultados del método Model::raw() antes de hidratar una instancia de modelo.

id Es un alias del campo _id en los documentos de MongoDB, y la biblioteca convierte automáticamente entre id y _id al consultar datos. El objeto de resultado de la consulta incluye un campo id que representa el campo _id del documento. Debido a este comportamiento, no es posible tener dos campos id y _id separados en los documentos.

En5.1 la versión 7600, la biblioteca también realiza esta conversión a los Model::raw() resultados del método antes de hidratar una instancia de modelo. Al pasar un filtro de consulta complejo, utilice el DB::where() método en lugar Model::raw() del.

A partir de5.3 la versión 7600, puede deshabilitar la conversión automática de id a _id para documentos incrustados. Para obtener más información, consulte la sección "Deshabilitar el uso de la conversión del nombre del campo id" de la guía "Opciones de conexión".

Elimina la compatibilidad con la propiedad $collection. El siguiente código muestra cómo asignar una colección de MongoDB a una variable de la clase User en versiones anteriores a la v5.0:

use MongoDB\Laravel\Eloquent\Model;
class User extends Model
{
    protected $keyType = 'string';
    // older versions
    protected $collection = 'app_user';
    // v5.0
    protected $table = 'app_user';
    ...
}

Esta versión también modifica los métodos DB y Schema asociados para acceder a una colección de MongoDB. El siguiente código muestra cómo acceder a la colección app_user en versiones anteriores a la v5.0:

use Illuminate\Support\Facades\Schema;
use Illuminate\Support\Facades\DB;
use MongoDB\Laravel\Schema\Blueprint;
// older versions
Schema::collection('app_user', function (Blueprint $collection) { ... });
DB::collection('app_user')->find($id);
// v5.0
Schema::table('app_user', function (Blueprint $table) { ... });
DB::table('app_user')->find($id);

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 archivo composer.json sea "mongodb/laravel-mongodb": "^4.0". Luego, ejecute composer update.

El espacio de nombres ahora es MongoDB\Laravel\. Asegúrate de cambiar el espacio de nombres 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 persiste el cambio. Asegúrese de seguir todas las llamadas a Model::unset($field) con Model::save().

Elimina el método Query\Builder::whereAll($column, $values). Asegúrate 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()Los métodos whereDay(), whereMonth(), whereYear() y whereTime() ahora utilizan operadores MongoDB en los campos de fecha.

Añade el atributo MongoDB\Laravel\Eloquent\MassPrunable. Asegúrate de reemplazar todas las instancias de Illuminate\Database\Eloquent\MassPrunable por MongoDB\Laravel\Eloquent\MassPrunable en 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()