edits

Author: norareidy

source/includes/read/distinct.php

@@ -1,40 +1,40 @@
 <?php
 require 'vendor/autoload.php';
 
+use MongoDB\BSON\Document;
+
 $uri = getenv('MONGODB_URI') ?: throw new RuntimeException('Set the MONGODB_URI variable to your Atlas URI that connects to the sample dataset');
 $client = new MongoDB\Client($uri);
 
 // start-db-coll
-$db = $client->sample_training;
-$collection = $db->companies;
+$collection = $client->sample_restaurants->restaurants;
 // end-db-coll
 
-// Finds one document with a "name" value of "LinkedIn"
-// start-find-one
-$document = $collection->findOne(['name' => 'LinkedIn']);
-echo json_encode($document) . "\n";
-// end-find-one
-
-// Finds documents with a "founded_year" value of 1970
-// start-find-many
-$results = $collection->find(['founded_year' => 1970]);
-// end-find-many
-
-// Prints documents with a "founded_year" value of 1970
-// start-cursor
-foreach ($results as $doc) {
-    echo json_encode($doc) . "\n";
+// Retrieves distinct values of the "borough" field
+// start-distinct
+$results = $collection->distinct('borough', []);
+foreach ($results as $value) {
+    echo json_encode($value) . PHP_EOL;
+}
+// end-distinct
+
+// Retrieves distinct "borough" field values for documents with a "cuisine" value of "Italian"
+// start-distinct-with-query
+$results = $collection->distinct('borough', ['cuisine' => 'Italian']);
+foreach ($results as $value) {
+    echo json_encode($value) . PHP_EOL;
 }
-// end-cursor
+// end-distinct-with-query
 
-// Finds and prints up to 5 documents with a "number_of_employees" value of 1000
-// start-modify
-$results = $collection->find(
-    ['number_of_employees' => 1000],
-    ['limit' => 5]
-);
+// Retrieves distinct "name" field values for documents matching the "borough" and "cuisine" fields query
+// and attaches a comment to the operation
+// start-distinct-with-comment
+$options = ['comment' => 'Bronx pizza restaurants'];
+$query = ['$and' => [['borough' => 'Bronx'], ['cuisine' => 'Pizza']]];
+$results = $collection->distinct('name', $query, $options);
 
-foreach ($results as $doc) {
-    echo json_encode($doc) . "\n";
+foreach ($results as $value) {
+    echo json_encode($value) . PHP_EOL;
 }
-// end-modify
+// end-distinct-with-comment
+

source/read.txt

@@ -9,4 +9,4 @@ Read Data from MongoDB
    :maxdepth: 1
 
    /read/retrieve
-   /read/distint
+   /read/distinct

source/read/distinct.txt

@@ -25,8 +25,8 @@ distinct values of a specified field across a collection.
 
 Within a collection, different documents might contain different values for a
 single field. For example, one document in a ``restaurants`` collection has a
-``borough`` value of ``"Manhattan"``, and another has a ``borough`` value of
-``"Queens"``. By using the {+php-library+}, you can retrieve all the unique values
+``borough`` value of ``'Manhattan'``, and another has a ``borough`` value of
+``'Queens'``. By using the {+php-library+}, you can retrieve all the unique values
 that a field contains across multiple documents in a collection.
 
 Sample Data
@@ -59,6 +59,7 @@ The following example retrieves the distinct values of the ``borough`` field in
 the ``restaurants`` collection:
 
 .. io-code-block::
+   :copyable:
 
    .. input:: /includes/read/distinct.php
       :start-after: start-distinct
@@ -67,10 +68,13 @@ the ``restaurants`` collection:
       :dedent:
 
    .. output:: 
+      :visible: false
 
-      { "values" : [ "Bronx", "Brooklyn", "Manhattan", "Missing", "Queens", "Staten Island" ],
-      "ok" : 1.0, "$clusterTime" : { "clusterTime" : { "$timestamp" : { ... } },
-      "signature" : { "hash" : { ... }, "keyId" : ... } }, "operationTime" : { "$timestamp" : { ... } }
+      "Bronx"
+      "Manhattan"
+      "Missing"
+      "Queens"
+      "Staten Island"
 
 The operation returns an array that stores each distinct ``borough`` field value. Although
 several documents have the same value in the ``borough`` field, each value appears in the
@@ -88,6 +92,7 @@ The following example retrieves the distinct values of the ``borough`` field for
 all documents that have a ``cuisine`` field value of ``'Italian'``:
 
 .. io-code-block::
+   :copyable:
 
    .. input:: /includes/read/distinct.php
       :start-after: start-distinct-with-query
@@ -96,10 +101,12 @@ all documents that have a ``cuisine`` field value of ``'Italian'``:
       :dedent:
 
    .. output:: 
+      :visible: false
 
-      { "values" : [ "Bronx", "Brooklyn", "Manhattan", "Queens", "Staten Island" ],
-      "ok" : 1.0, "$clusterTime" : { "clusterTime" : { "$timestamp" : { ... },
-      "signature" : { "hash" : { ... }, "keyId" : ... } }, "operationTime" : { "$timestamp" : { ... } }
+      "Bronx"
+      "Manhattan"
+      "Queens"
+      "Staten Island"
 
 Modify Distinct Behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -138,6 +145,7 @@ all documents that have a ``borough`` field value of ``'Bronx'`` and a
 in an options array to add a comment to the operation:
 
 .. io-code-block::
+   :copyable:
 
    .. input:: /includes/read/distinct.php
       :start-after: start-distinct-with-comment
@@ -146,9 +154,16 @@ in an options array to add a comment to the operation:
       :dedent:
 
    .. output:: 
-
-      { "values" : [ "$1.25 Pizza", "18 East Gunhill Pizza", "2 Bros", "Aenos Pizza", "Alitalia Pizza Restaurant", … ], 
-        "ok" : 1.0, "$clusterTime" : { "clusterTime" : { … }, "signature" : { … }, "keyId" : … } }, "operationTime" : { … } }
+      :visible: false
+
+      "$1.25 Pizza"
+      "18 East Gunhill Pizza"
+      "2 Bros"
+      "Aenos Pizza"
+      "Alitalia Pizza Restaurant"
+      "Amici Pizza And Pasta"
+      "Angie'S Cafe Pizza"
+      ...
 
 API Documentation
 -----------------