MongoDB\Driver\BulkWrite::insert

public MongoDB\Driver\BulkWrite::insert(array $documento): mixed
```php

Añade una operación de inserción a la `MongoDB\Driver\BulkWrite`.

## Parámetros

`documento` (`arrayobject`)  
Un documento a insertar.

## Valores devueltos

Devuelve el `_id` del documento insertado. Si el `documento` no tenía un `_id`, se devolverá el `MongoDB\BSON\ObjectId` generado para la inserción.

## Errores/Excepciones

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

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

## Historial de cambios

| Versión | Descripción |
|----|----|
| PECL mongodb 1.3.0 | Siempre se devuelve el `_id` del documento insertado. Anteriormente, el método solo devolvía un valor si se generaba un `MongoDB\BSON\ObjectId`. |

## Ejemplos

Ejemplo de `MongoDB\Driver\BulkWrite::insert`

object(MongoDB\BSON\ObjectId)#3 (1) {
  ["oid"]=>
  string(24) "67f58058d1a0aa2fd80d55d0"
}
string(18) "id-personalizado"
object(MongoDB\BSON\ObjectId)#4 (1) {
  ["oid"]=>
  string(24) "0123456789abcdef01234567"
}