Documentación offline PHP master
/

MongoDB\Driver\Cursor::setTypeMap

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

MongoDB\Driver\Cursor::setTypeMap

Establece un mapa de tipos para usar en la deserialización BSON

Descripción#

final public MongoDB\Driver\Cursor::setTypeMap(array $typemap): void
```php

Establece la [configuración del mapa de tipos](#mongodb.persistence.typemaps) que se usará al deserializar los resultados BSON en valores de PHP.

## Parámetros

`typeMap` (`array`)  
[Configuración del mapa de tipos](#mongodb.persistence.typemaps).

## Valores devueltos

No se retorna ningún valor.

## Errores/Excepciones

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

en caso de error durante el análisis de un argumento.

Al iterar sobre el cursor, también se pueden lanzar las siguientes excepciones debido a una configuración incorrecta del mapa de tipos: Lanza `MongoDB\Driver\Exception\InvalidArgumentException` si una clase en el mapa de tipos no puede ser instanciada o no implementa MongoDB\BSON\Unserializable.

## Ejemplos

Ejemplo de `MongoDB\Driver\Cursor::setTypeMap`
insert(['x' => 1]); $manager->executeBulkWrite('db.collection', $bulk); $query = new MongoDB\Driver\Query(['_id' => $id]); $cursor = $manager->executeQuery('db.collection', $query); $cursor->setTypeMap(['root' => 'array']); foreach ($cursor as $document) { var_dump($document); } ?>

```php

Resultado del ejemplo anterior es similar a:

array(2) {
  ["_id"]=>
  object(MongoDB\BSON\ObjectId)#6 (1) {
    ["oid"]=>
    string(24) "56424fb76118fd3267180741"
  }
  ["x"]=>
  int(1)
}

Véase también#