CakeFest 2017 NYC, the Official CakePHP Conference


Table of Contents


This extension is deprecated. Instead, the MongoDB extension should be used.

This is the official MongoDB driver for PHP.

Here's a quick code sample that connects, inserts documents, queries for documents, iterates through query results, and disconnects from MongoDB. There are more details on each step in the tutorial below.


// connect
$m = new MongoClient();

// select a database
$db $m->comedy;

// select a collection (analogous to a relational database's table)
$collection $db->cartoons;

// add a record
$document = array( "title" => "Calvin and Hobbes""author" => "Bill Watterson" );

// add another record, with a different "shape"
$document = array( "title" => "XKCD""online" => true );

// find everything in the collection
$cursor $collection->find();

// iterate through the results
foreach ($cursor as $document) {
$document["title"] . "\n";


The above example will output:

Calvin and Hobbes
add a note add a note

User Contributed Notes 3 notes

Josh Heidenreich
6 years ago
If you are getting "writing more" shown at random places on the screen, it's a MongoDB connector bug in 1.0.5.

Bug report:

Update to the latest connector driver and it should go away.
pgl at yoyo dot org
3 years ago
To use a collection with periods in its name, quote it with braces:

= new MongoClient();

$cursor = $m->test->{'test.test'}->find();

## equivalent to the following:
#$db = $m->test;
#$collection = $db->{'test.test'};
#$cursor = $collection->find();

foreach ($cursor as $doc) {
php at whoah dot net
6 years ago
Make sure array keys consecutive before inserting. As of 1.0.6 driver, the following will end up as an object of key:value pairs, instead of an array, because it's trying to maintain the 0 and 2 keys:

$array = array('a', 'b', 'c');

$document = array(
'embedded' => $array,

// assuming local
$mongo = new Mongo();

mongodb result:
{ "_id" : ObjectId(...), "embedded" : { "0" : "a", "2" : "c" } }

This is bad if you plan on indexing the embedded property as an array because objects and arrays are indexed differently.

Whether the behaviour will change or not, this is logged here:

If you know about it, it's not major, just use a sort() before inserting, or use array_* methods to remove elements instead of unset() -- anything that will re-adjust keys.
To Top