Merge 4.1 into 4.2 (#2932)

Author: mongodb-php-bot

docs/query-builder.txt

@@ -73,7 +73,10 @@ Before You Get Started
 To run the code examples in this guide, complete the
 :ref:`Quick Start <laravel-quick-start>` tutorial to configure a web
 application, load sample datasets into your MongoDB deployment, and
-run the example code from a controller method.
+run the example code from a controller method. To see the expected code
+output as JSON documents, use the ``toJson()`` method shown in the optional
+:ref:`View your results as JSON documents <laravel-quick-start-json>` step
+of the Quick Start.
 
 To perform read and write operations by using the query builder, import the
 ``Illuminate\Support\Facades\DB`` facade and compose your query.

docs/quick-start/view-data.txt

@@ -136,6 +136,29 @@ View MongoDB Data
 
          </body>
          </html>
+ 
+   .. _laravel-quick-start-json:
+
+   .. step:: Optionally, view your results as JSON documents
+
+      Rather than generating a view and editing the ``browse_movie.blade.php`` file, you can
+      use the ``toJson()`` method to display your results in JSON format.
+      
+      Replace the ``show()`` function with the following code to retrieve results and
+      return them as JSON documents:
+
+      .. code-block:: php
+
+         public function show()
+         {
+             $results = Movie::where('runtime', '<', 60)
+                 ->where('imdb.rating', '>', 8.5)
+                 ->orderBy('imdb.rating', 'desc')
+                 ->take(10)
+                 ->get();
+
+             return $results->toJson();
+         }
 
    .. step:: Start your Laravel application