<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Tutorial</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="mongo.manual.html">Manual</a></div>
<div class="next" style="text-align: right; float: right;"><a href="mongo.tutorial.connecting.html">Making a Connection</a></div>
<div class="up"><a href="mongo.manual.html">Manual</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="mongo.tutorial" class="chapter">
<h1>Tutorial</h1>
<h2>Table of Contents</h2><ul class="chunklist chunklist_chapter"><li><a href="mongo.tutorial.connecting.html">Making a Connection</a></li><li><a href="mongo.tutorial.selectdb.html">Getting a Database</a></li><li><a href="mongo.tutorial.collection.html">Getting A Collection</a></li><li><a href="mongo.tutorial.insert.html">Inserting a Document</a></li><li><a href="mongo.tutorial.findone.html">Finding Documents using MongoCollection::findOne</a></li><li><a href="mongo.tutorial.insert.multiple.html">Adding Multiple Documents</a></li><li><a href="mongo.tutorial.counting.html">Counting Documents in A Collection</a></li><li><a href="mongo.tutorial.cursor.html">Using a Cursor to Get All of the Documents</a></li><li><a href="mongo.tutorial.criteria.html">Setting Criteria for a Query</a></li><li><a href="mongo.tutorial.multi.query.html">Getting A Set of Documents With a Query</a></li><li><a href="mongo.tutorial.indexes.html">Creating An Index</a></li></ul>
<p class="para">
This is the official MongoDB driver for PHP.
</p>
<p class="para">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.
</p>
<div class="example" id="mongo.tutorial.basics">
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /><br /></span><span style="color: #FF8000">// connect<br /></span><span style="color: #0000BB">$m </span><span style="color: #007700">= new </span><span style="color: #0000BB">MongoClient</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">// select a database<br /></span><span style="color: #0000BB">$db </span><span style="color: #007700">= </span><span style="color: #0000BB">$m</span><span style="color: #007700">-></span><span style="color: #0000BB">comedy</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// select a collection (analogous to a relational database's table)<br /></span><span style="color: #0000BB">$collection </span><span style="color: #007700">= </span><span style="color: #0000BB">$db</span><span style="color: #007700">-></span><span style="color: #0000BB">cartoons</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// add a record<br /></span><span style="color: #0000BB">$document </span><span style="color: #007700">= array( </span><span style="color: #DD0000">"title" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"Calvin and Hobbes"</span><span style="color: #007700">, </span><span style="color: #DD0000">"author" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"Bill Watterson" </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$collection</span><span style="color: #007700">-></span><span style="color: #0000BB">insert</span><span style="color: #007700">(</span><span style="color: #0000BB">$document</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// add another record, with a different "shape"<br /></span><span style="color: #0000BB">$document </span><span style="color: #007700">= array( </span><span style="color: #DD0000">"title" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"XKCD"</span><span style="color: #007700">, </span><span style="color: #DD0000">"online" </span><span style="color: #007700">=> </span><span style="color: #0000BB">true </span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$collection</span><span style="color: #007700">-></span><span style="color: #0000BB">insert</span><span style="color: #007700">(</span><span style="color: #0000BB">$document</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// find everything in the collection<br /></span><span style="color: #0000BB">$cursor </span><span style="color: #007700">= </span><span style="color: #0000BB">$collection</span><span style="color: #007700">-></span><span style="color: #0000BB">find</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">// iterate through the results<br /></span><span style="color: #007700">foreach (</span><span style="color: #0000BB">$cursor </span><span style="color: #007700">as </span><span style="color: #0000BB">$document</span><span style="color: #007700">) {<br /> echo </span><span style="color: #0000BB">$document</span><span style="color: #007700">[</span><span style="color: #DD0000">"title"</span><span style="color: #007700">] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
Calvin and Hobbes
XKCD
</pre></div>
</div>
</div>
</div>
<hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="mongo.manual.html">Manual</a></div>
<div class="next" style="text-align: right; float: right;"><a href="mongo.tutorial.connecting.html">Making a Connection</a></div>
<div class="up"><a href="mongo.manual.html">Manual</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
