<!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>