Inserts multiple documents into this collection

MongoCollection
MongoCollection::__construct
MongoCollection
PHP Manual

# MongoCollection::batchInsert

(PECL mongo >=0.9.0)

MongoCollection::batchInsert — Inserts multiple documents into this collection

### Description

public mixed MongoCollection::batchInsert ( array `$a` [, array `$options` = array() ] )

### Parameters

`a`

  An array of arrays.

`options`

  Options for the inserts.

  - "safe"

    Check that the inserts succeeded.

### Return Values

If "safe" is set, returns an associative array with the status of the inserts ("ok") and any error that may have occured ("err"). Otherwise, returns `TRUE` if the batch insert was successfully sent, `FALSE` otherwise.

### Errors/Exceptions

Throws MongoCursorException if the "safe" option is set and the insert fails.

### Changelog

Version | Description
--- | ---
1.0.5 | Added "options" parameter.

### Examples

Example #1 MongoCollection::batchInsert() example

Batch insertion is a quick way to add many elements to the database at once

`<?php
$users = array();
for ($i = 0; $i<100; $i++) {
$users[] = array('username' => 'user'.$i, 'i' => $i);
}
$mongo = new Mongo();
$collection = $mongo->my_db->users;
$collection->drop();
$collection->batchInsert($users);
foreach ($users as $user) {
echo $user['_id']."\n"; // populated with instanceof MongoId
}
$users = $collection->find()->sort(array('i' => 1));
foreach ($users as $user) {
var_dump($user['username']);
}
?>`

The above example will output something similar to:

    4bf43ac68ead0e1971000000
    4bf43ac68ead0e1971010000
    4bf43ac68ead0e1971020000
    ...
    string(5) "user1"
    string(5) "user2"
    string(5) "user3"
    ...

MongoCollection
MongoCollection::__construct
MongoCollection
PHP Manual